PHPackages open-telemetry/opentelemetry-auto-psr3 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. open-telemetry/opentelemetry-auto-psr3 ActiveLibrary[Logging & Monitoring](/categories/logging) open-telemetry/opentelemetry-auto-psr3 ====================================== OpenTelemetry auto-instrumentation for PSR-3 (Logger Interface). 0.2.0(1mo ago)01.0M—6.4%1Apache-2.0PHPPHP ^8.1 Since Jun 27Pushed 1mo ago3 watchersCompare [ Source](https://github.com/opentelemetry-php/contrib-auto-psr3)[ Packagist](https://packagist.org/packages/open-telemetry/opentelemetry-auto-psr3)[ Docs](https://opentelemetry.io/docs/languages/php/)[ RSS](/packages/open-telemetry-opentelemetry-auto-psr3/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (36)Versions (13)Used By (1) [![Releases](https://camo.githubusercontent.com/46e38a504120203bf7615645011bcf2bb834e03e8eb0bc8e0f4864c729fd5baf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656c65617365732d707572706c65)](https://github.com/opentelemetry-php/contrib-auto-psr3/releases)[![Issues](https://camo.githubusercontent.com/b9b31135f113cdb6e2b662b4040276044ee0803567bc17688eaf4386f797ea50/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6973737565732d70696e6b)](https://github.com/open-telemetry/opentelemetry-php/issues)[![Source](https://camo.githubusercontent.com/e27dd1126a60abf1c26521d893d9f235ef342a76231c2428ddbc4651185bd626/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d636f6e747269622d677265656e)](https://github.com/open-telemetry/opentelemetry-php-contrib/tree/main/src/Instrumentation/Psr3)[![Mirror](https://camo.githubusercontent.com/2f9050293ab0c0d9471e618215bc7417a63b6873c960e1605bddb69b1911fa4c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d6972726f722d6f70656e74656c656d657472792d2d7068702d2d636f6e747269622d626c7565)](https://github.com/opentelemetry-php/contrib-auto-psr3)[![Latest Version](https://camo.githubusercontent.com/7d67fccec867523866ebf6b8f01fe554051ecbf60d1972fcfffa313345933b6f/687474703a2f2f706f7365722e707567782e6f72672f6f70656e2d74656c656d657472792f6f70656e74656c656d657472792d6175746f2d707372332f762f756e737461626c65)](https://packagist.org/packages/open-telemetry/opentelemetry-auto-psr3/)[![Stable](https://camo.githubusercontent.com/ff1e173303957d09b8c322cb496bfa2415b2413182b76bf8c23bd541d9a00595/687474703a2f2f706f7365722e707567782e6f72672f6f70656e2d74656c656d657472792f6f70656e74656c656d657472792d6175746f2d707372332f762f737461626c65)](https://packagist.org/packages/open-telemetry/opentelemetry-auto-psr3/) This is a read-only subtree split of . OpenTelemetry PSR-3 auto-instrumentation ======================================== [](#opentelemetry-psr-3-auto-instrumentation) Please read for instructions on how to install and configure the extension and SDK. Overview -------- [](#overview) Auto-instrumentation hooks are registered via composer, and depending on the mode, will: - automatically inject trace id and span id into log message context of any psr3 logger; or - transform the message into the OpenTelemetry LogRecord format, for export to an OpenTelemetry logging-compatible backend Mode ---- [](#mode) The package can operate in two modes, controlled by the environment variable `OTEL_PHP_PSR3_MODE`: ### `inject` [](#inject) Inject `trace_id` and `span_id` of the active trace span into the context of each logged message. Depending on the PSR-3 implementation, the values may be written to the log output, or may be available for interpolation into the log message. For example: ``` putenv('OTEL_PHP_PSR3_MODE=inject'); require 'vendor/autoload.php'; $logger = /* create logger */ $logger->info('trace_id={trace_id} span_id={span_id}'); ``` ### `export` [](#export) The logged output will be processed and emitted by the logger as normal, but the output will also be encoded using the [OpenTelemetry log model](https://opentelemetry.io/docs/specs/otel/logs/data-model/) and can be exported to an OpenTelemetry-compatible backend. ``` putenv('OTEL_PHP_PSR3_MODE=export'); putenv('OTEL_PHP_AUTOLOAD_ENABLED=true'); putenv('OTEL_LOGS_EXPORTER=console'); require 'vendor/autoload.php'; $logger = /* create logger */ $logger->info('Hello, OTEL'); ``` Configuration ------------- [](#configuration) The extension can be disabled via [runtime configuration](https://opentelemetry.io/docs/instrumentation/php/sdk/#configuration): ``` OTEL_PHP_DISABLED_INSTRUMENTATIONS=psr3 ``` ### Health Score 52 — FairBetter than 96% of packages Maintenance89 Actively maintained with recent releases Popularity38 Limited adoption so far Community20 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~91 days Recently: every ~134 days Total 12 Last Release 55d ago PHP version history (2 changes)0.0.1PHP ^8.0 0.0.9PHP ^8.1 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4978962?v=4)[Brett McBride](/maintainers/brettmc)[@brettmc](https://github.com/brettmc) ![](https://avatars.githubusercontent.com/u/4099109?v=4)[Bob Strecansky](/maintainers/bobstrecansky)[@bobstrecansky](https://github.com/bobstrecansky) --- Top Contributors [![brettmc](https://avatars.githubusercontent.com/u/4978962?v=4)](https://github.com/brettmc "brettmc (9 commits)")[![weslenteche](https://avatars.githubusercontent.com/u/54692047?v=4)](https://github.com/weslenteche "weslenteche (3 commits)")[![agoallikmaa](https://avatars.githubusercontent.com/u/3532037?v=4)](https://github.com/agoallikmaa "agoallikmaa (2 commits)")[![bobstrecansky](https://avatars.githubusercontent.com/u/4099109?v=4)](https://github.com/bobstrecansky "bobstrecansky (1 commits)")[![ChrisLightfootWild](https://avatars.githubusercontent.com/u/106102472?v=4)](https://github.com/ChrisLightfootWild "ChrisLightfootWild (1 commits)")[![drghdtjr](https://avatars.githubusercontent.com/u/87798442?v=4)](https://github.com/drghdtjr "drghdtjr (1 commits)")[![intuibase](https://avatars.githubusercontent.com/u/9551626?v=4)](https://github.com/intuibase "intuibase (1 commits)")[![julianocosta89](https://avatars.githubusercontent.com/u/15364991?v=4)](https://github.com/julianocosta89 "julianocosta89 (1 commits)")[![pieterocp](https://avatars.githubusercontent.com/u/68863060?v=4)](https://github.com/pieterocp "pieterocp (1 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (1 commits)")[![ahkui](https://avatars.githubusercontent.com/u/14049597?v=4)](https://github.com/ahkui "ahkui (1 commits)") --- Tags tracingopentelemetryotelPSR3instrumentationopen-telemetry ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/open-telemetry-opentelemetry-auto-psr3/health.svg) ``` [![Health](https://phpackages.com/badges/open-telemetry-opentelemetry-auto-psr3/health.svg)](https://phpackages.com/packages/open-telemetry-opentelemetry-auto-psr3) ``` ### Alternatives [open-telemetry/opentelemetry-auto-symfony OpenTelemetry auto-instrumentation for Symfony 551.2M1](/packages/open-telemetry-opentelemetry-auto-symfony)[open-telemetry/sdk SDK for OpenTelemetry PHP. 2322.9M248](/packages/open-telemetry-sdk)[open-telemetry/opentelemetry-auto-pdo OpenTelemetry auto-instrumentation for PDO 111.2M1](/packages/open-telemetry-opentelemetry-auto-pdo)[open-telemetry/opentelemetry-auto-wordpress OpenTelemetry auto-instrumentation for Wordpress 17166.0k](/packages/open-telemetry-opentelemetry-auto-wordpress) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)