PHPackages open-telemetry/opentelemetry-metrics-runtime - 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-metrics-runtime ActiveLibrary[Logging & Monitoring](/categories/logging) open-telemetry/opentelemetry-metrics-runtime ============================================ OpenTelemetry PHP runtime metrics (memory, GC, OPcache, CPU) 0.2.0(1mo ago)01.0k↓66.7%Apache-2.0PHPPHP ^8.1CI passing Since Jul 8Pushed 1mo agoCompare [ Source](https://github.com/opentelemetry-php/contrib-metrics-runtime)[ Packagist](https://packagist.org/packages/open-telemetry/opentelemetry-metrics-runtime)[ Docs](https://opentelemetry.io/docs/languages/php/)[ RSS](/packages/open-telemetry-opentelemetry-metrics-runtime/feed)WikiDiscussions main Synced 1w ago READMEChangelog (2)Dependencies (26)Versions (3)Used By (0) [![Releases](https://camo.githubusercontent.com/46e38a504120203bf7615645011bcf2bb834e03e8eb0bc8e0f4864c729fd5baf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656c65617365732d707572706c65)](https://github.com/open-telemetry/opentelemetry-php-contrib/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/Metrics/Runtime)[![Latest Version](https://camo.githubusercontent.com/ef0592b016e8f625b27514ae922c626cebb6e76fe08161230cfd1c760687f8b5/687474703a2f2f706f7365722e707567782e6f72672f6f70656e2d74656c656d657472792f6f70656e74656c656d657472792d6d6574726963732d72756e74696d652f762f756e737461626c65)](https://packagist.org/packages/open-telemetry/opentelemetry-metrics-runtime/)[![Stable](https://camo.githubusercontent.com/e25dc3c905c30348df515d01114fe55c80e532849c0c6da0ada27ad9e008941e/687474703a2f2f706f7365722e707567782e6f72672f6f70656e2d74656c656d657472792f6f70656e74656c656d657472792d6d6574726963732d72756e74696d652f762f737461626c65)](https://packagist.org/packages/open-telemetry/opentelemetry-metrics-runtime/) This is a read-only subtree split of . OpenTelemetry PHP Runtime Metrics ================================= [](#opentelemetry-php-runtime-metrics) Collects PHP runtime metrics — memory, garbage collection, OPcache, and CPU usage — and exposes them as OpenTelemetry observable instruments. Requirements ------------ [](#requirements) - PHP 8.1+ - OpenTelemetry API Installation ------------ [](#installation) ``` composer require open-telemetry/opentelemetry-metrics-runtime ``` Usage ----- [](#usage) ### Automatic (recommended) [](#automatic-recommended) The package registers itself via [SPI](https://github.com/Nevay/spi) as an `Instrumentation`. When the OpenTelemetry SDK calls `SdkAutoloader::autoload()`, metrics are registered automatically with the configured `MeterProvider`. No additional code is required. ``` OTEL_PHP_AUTOLOAD_ENABLED=true OTEL_METRICS_EXPORTER=otlp OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 ``` ### Manual [](#manual) If you need to control when metrics are registered: ``` use OpenTelemetry\Contrib\Metrics\Runtime\RuntimeMetrics; use OpenTelemetry\Contrib\Metrics\Runtime\RuntimeMetricsConfig; RuntimeMetrics::register($meterProvider); // Optionally, disable individual groups (memory, gc, opcache, cpu): RuntimeMetrics::register($meterProvider, new RuntimeMetricsConfig(disabled: ['opcache', 'cpu'])); ``` Metrics ------- [](#metrics) ### Memory (`memory`) [](#memory-memory) MetricTypeUnitDescription`php.memory.usage`UpDownCounter`By`Current memory usage. Reported for `emalloc` (PHP internal allocation) and `overhead` (additional OS allocation beyond `emalloc`) via the `memory.type` attribute; the two sum to the real OS allocation.`php.memory.peak_usage`UpDownCounter`By`Peak memory usage since script start. Same `memory.type` attribute breakdown.`php.memory.limit`Gauge`By`Memory limit from `php.ini`. `-1` means unlimited.### Garbage Collection (`gc`) [](#garbage-collection-gc) MetricTypeUnitDescription`php.gc.runs`Counter`{run}`Total number of GC cycles run.`php.gc.collected`Counter`{object}`Total number of objects collected.`php.gc.roots`Gauge`{object}`Current number of objects in the root buffer.`php.gc.threshold`Gauge`{object}`Number of roots required to trigger a GC cycle.`php.gc.collector_time`Counter`s`Cumulative time spent in the GC collector. **PHP 8.3+**`php.gc.destructor_time`Counter`s`Cumulative time spent running destructors during GC. **PHP 8.3+**`php.gc.free_time`Counter`s`Cumulative time spent freeing memory during GC. **PHP 8.3+**### OPcache (`opcache`) [](#opcache-opcache) Registered only when OPcache is enabled (`opcache.enable=1`). In CLI context, also requires `opcache.enable_cli=1`. MetricTypeUnitDescription`php.opcache.memory_used`UpDownCounter`By`Memory used by cached scripts.`php.opcache.memory_free`UpDownCounter`By`Free memory in the OPcache buffer.`php.opcache.memory_wasted`UpDownCounter`By`Wasted (fragmented) memory — requires restart to reclaim.`php.opcache.hits`Counter`{hit}`Total cache hits.`php.opcache.misses`Counter`{miss}`Total cache misses.`php.opcache.hit_rate`Gauge`%`Cache hit rate percentage.`php.opcache.cached_scripts`Gauge`{script}`Number of scripts currently in cache.`php.opcache.interned_strings.memory_used`UpDownCounter`By`Memory used by interned strings.`php.opcache.interned_strings.memory_free`UpDownCounter`By`Free memory in the interned strings buffer.`php.opcache.interned_strings.count`Gauge`{string}`Number of interned strings currently stored.### CPU (`cpu`) [](#cpu-cpu) Registered only on platforms where `getrusage()` is available (Linux, macOS, Windows). MetricTypeUnitDescription`process.cpu.time`Counter`s`CPU time consumed. Reported for `user` and `system` modes via the `cpu.mode` attribute.`process.context_switches`Counter`{context_switch}`Number of times the process has been context switched. Reported for `voluntary` and `involuntary` switches via the `process.context_switch.type` attribute.Configuration ------------- [](#configuration) ### Disable the entire package [](#disable-the-entire-package) ``` OTEL_PHP_DISABLED_INSTRUMENTATIONS=metrics-runtime ``` ### Disable individual metric groups [](#disable-individual-metric-groups) **Option 1: via `OTEL_PHP_DISABLED_INSTRUMENTATIONS`** — lightweight, no config file needed. Each group is addressed as `metrics-runtime-{group}`: ``` # Disable OPcache and CPU metrics only OTEL_PHP_DISABLED_INSTRUMENTATIONS=metrics-runtime-opcache,metrics-runtime-cpu # Disable GC metrics only OTEL_PHP_DISABLED_INSTRUMENTATIONS=metrics-runtime-gc ``` GroupInstrumentation name`memory``metrics-runtime-memory``gc``metrics-runtime-gc``opcache``metrics-runtime-opcache``cpu``metrics-runtime-cpu`**Option 2: via `OTEL_CONFIG_FILE`** — standard OTel SDK configuration, supports fine-grained control (e.g. filtering by attributes). Each group uses its own meter named `io.opentelemetry.contrib.php.runtime.{group}`, which can be targeted with meter configurators or views: ``` # otel-config.yaml meter_provider: views: - selector: meter_name: io.opentelemetry.contrib.php.runtime.opcache stream: aggregation: drop: ``` ``` OTEL_CONFIG_FILE=/path/to/otel-config.yaml ``` Maintainer ---------- [](#maintainer) [@intuibase](https://github.com/intuibase) ### Health Score 40 — FairBetter than 86% of packages Maintenance91 Actively maintained with recent releases Popularity21 Limited adoption so far Community6 Small or concentrated contributor base Maturity33 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 ~0 days Total 2 Last Release 48d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4099109?v=4)[Bob Strecansky](/maintainers/bobstrecansky)[@bobstrecansky](https://github.com/bobstrecansky) --- Top Contributors [![intuibase](https://avatars.githubusercontent.com/u/9551626?v=4)](https://github.com/intuibase "intuibase (1 commits)") --- Tags phpMetricsopentelemetryotelruntimeopen-telemetry ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/open-telemetry-opentelemetry-metrics-runtime/health.svg) ``` [![Health](https://phpackages.com/badges/open-telemetry-opentelemetry-metrics-runtime/health.svg)](https://phpackages.com/packages/open-telemetry-opentelemetry-metrics-runtime) ``` ### Alternatives [open-telemetry/sdk SDK for OpenTelemetry PHP. 2430.8M445](/packages/open-telemetry-sdk)[open-telemetry/opentelemetry-auto-laravel OpenTelemetry auto-instrumentation for Laravel 593.1M9](/packages/open-telemetry-opentelemetry-auto-laravel)[open-telemetry/opentelemetry-auto-symfony OpenTelemetry auto-instrumentation for Symfony 571.8M5](/packages/open-telemetry-opentelemetry-auto-symfony)[keepsuit/laravel-opentelemetry OpenTelemetry integration for laravel 173666.7k1](/packages/keepsuit-laravel-opentelemetry)[open-telemetry/opentelemetry-auto-pdo OpenTelemetry auto-instrumentation for PDO 111.9M4](/packages/open-telemetry-opentelemetry-auto-pdo)[traceway/opentelemetry-symfony Pure-PHP OpenTelemetry instrumentation for Symfony — automatic HTTP, Console, HttpClient, Messenger, Doctrine DBAL, Cache, Twig tracing and Monolog log-trace correlation with response propagation, a lightweight Tracing helper, route templates, and semantic conventions. No C extension required (ext-protobuf recommended for production). 8022.8k](/packages/traceway-opentelemetry-symfony) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)