NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #296 most downloaded on Packagist
API for OpenTelemetry PHP.
Latest stable
1.12.0
Last release 3 days ago
19 Nov 2026
Ships fairly regularly
a new release about every 6 weeks
Most releases are documented
notes for 39 of 54 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
54 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
MeterInterface::createGauge() and GaugeInterface are no longer experimental. The synchronous Gauge is stable in the specification ( #2129 ).
MeterInterface::createGauge() and GaugeInterface are no longer experimental. The synchronous Gauge is stableWithSpanHandler uses the span name of #[WithSpan(span_name: '...')]. Only the positional form#[WithSpan('...')] set it; the named form fell back to Class::method (#2119).OTEL_LOG_LEVEL value logs a warning and falls back to info. It used to fallinfo silently (#2125).Full Changelog: 1.11.0...1.12.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
trace() and WithSpanHandler no longer set exception.escaped, which semantic conventions deprecated ([#2092]).
open-telemetry/sdk-configuration below 0.10, which registers the same
propagator providers. Upgrade it with this package (#2107).ConfigProviderInterface::getInstrumentationConfig() takes an optional Context. Implementations
must add the parameter. The interface is experimental (#2076).symfony/polyfill-php82 (#2091).tracecontext and baggage propagator providers for declarative configuration, registered
through SPI. They used to ship in open-telemetry/sdk-configuration (#2107).Severity::fromName() and Severity::toPsr3() (#2068).Context::withLogger() (#2068).Logging::setLogLevel(), which takes precedence over OTEL_LOG_LEVEL, and
Logging::restoreLogLevel() (#2068).symfony/config is suggested, for implementing a ComponentProvider (#2097).Context's default logger writes to the internal logger, filtered by OTEL_LOG_LEVEL. It was a
NullLogger (#2068).trace() and WithSpanHandler no longer set exception.escaped, which semantic conventions
deprecated (#2092).TracerInterface::isEnabled() and Instrument::isEnabled() are no longer experimental
(#2092).ConfigProviderInterface, NoopConfigProvider and
NoopConfigProperties (#2076), ConfigProperties and ConfigurationRegistry (#2093),
HttpConfig and PeerConfig (#2097).SystemClock has its own reference time. It used to be shared by all instances (#2041).LogsMessagesTrait swallows the
exception (#2101).NoopEventLogger and NoopEventLoggerProvider, with the rest of the Events API (#2092).Full Changelog: https://github.com/opentelemetry-php/api/compare/1.10.1...1.11.0
Fix baggage propagator drops entries containing percent-encoded values by @Nevay in 2056
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.10.0...1.10.1
fix: preserve debug log level priority in Logging::level() by @jorgsowa in 1991
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.9.0...1.10.0
Deprecate API InstrumentationInterface and ConfigurationResolver by @Nevay in 1896
What's Changed:
API InstrumentationInterface and ConfigurationResolver by @Nevay in 1896Full Changelog: https://github.com/opentelemetry-php/api/compare/1.8.0...1.9.0
generate semconv 1.38.0 by @brettmc in 1855
Propagate Trace Context Level 2 random flag by @Nevay in 1731
What's Changed:
ResourceInfo available to component providers by @Nevay in 1729Full Changelog: 1.7.0...1.7.1
Implement span suppression strategies by @Nevay in 1599
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.6.0...1.7.0
feat: Add experimental response propagator interface by @jerrytfleung in 1712
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.5.0...1.6.0
What's Changed:
Full Changelog: 1.5.0...1.6.0
stabilize LocalRootSpan by @brettmc in 1683
add Logger.Enabled event name parameter by @brettmc in 1632
What's Changed:
Full Changelog: 1.3.0...1.4.0
stabilize logger.enabled by @brettmc in 1580
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.2.3...1.3.0
Fix type error when using LateBindingMeter::createObservable{Instrument}() by @Nevay in 1524
What's Changed:
LateBindingMeter::createObservable{Instrument}() by @Nevay in 1524Full Changelog: https://github.com/opentelemetry-php/api/compare/1.2.2...1.2.3
fix gRPC timeout (#1498) by @spadger in 1499
support refactored otlp export config by @brettmc in 1477
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.2.0...1.2.1
deprecate event logger by @brettmc in 1466
Added \Attribute::TARGET_PARAMETER to \OpenTelemetry\API\Instrumentation\SpanAttribute by @ChrisLightfootWild in 1433
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.1.1...1.1.2
Add TextMapPropagator to instrumentation context by @Nevay in 1401
What's Changed: Full Changelog: https://github.com/opentelemetry-php/api/compare/1.1.0beta3...1.1.0
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.1.0beta3...1.1.0
log previous exception message from error writer by @brettmc in 1231
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.2...1.0.3
Add support for multi-instrument callbacks by @Nevay in 1202
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.1...1.0.2
Add instrument advisory parameter by @Nevay in 1186
What's Changed: Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0RC2...1.0.0
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0RC2...1.0.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Remove MeterInterface::isEnabled() and recreate metric streams on config re-enabling by @Nevay in 1387
What's Changed:
MeterInterface::isEnabled() and recreate metric streams on config re-enabling by @Nevay in 1387Full Changelog: https://github.com/opentelemetry-php/api/compare/1.1.0beta2...1.1.0beta3
fix withspan handler nullable + example by @brettmc in 1377
[PHP 8.4] Fixes for implicit nullability deprecation by @andypost in 1297
What's Changed:
Span::addLink() and Meter::createGauge() by @Nevay in 1289Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.3...1.1.0beta1
Add branch aliases by @Nevay in 988
relax default logging levels by @brettmc in 975
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0beta7...1.0.0beta8
apply logging spec updates by @brettmc in 977
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0beta6...1.0.0beta7
documenting logs bridge api, adding memory exporter by @brettmc in 959
adding logs signal by @brettmc in #934
fixing empty tracestate header handling by @brettmc in #936
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0beta3...1.0.0beta4
Full Changelog: https://github.com/opentelemetry-php/api/commits/1.0.0beta3
Full Changelog: https://github.com/opentelemetry-php/api/commits/1.0.0beta3
Nothing published for this version
fixing some psalm 5 complaints by @brettmc in 1110
remove deprecated code and BC hacks by @brettmc in 1099
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0beta11...1.0.0beta12
adding configuration resolver by @brettmc in 1083
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0beta10...1.0.0beta11
fixing broken links by @brettmc in 1052
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0beta9...1.0.0beta10
Nothing published for this version
remove global configuration resolver by @brettmc in 1118
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0RC1...1.0.0RC2
Add 'Contributing' message by @stickeegreg in 1108
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/api/compare/1.0.0beta13...1.0.0RC1
One column per quarter.