NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #405 most downloaded on Packagist
SDK for OpenTelemetry PHP.
Latest stable
1.17.0
Last release 3 days ago
19 Nov 2026
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 54 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
69 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
An exporter built without a temporality is not deprecated. It uses each stream's temporality until 2.0, which is delta for synchronous instruments and…
Configuration::getEnum() now returns lowercase values. Callers outside the SDK that compare its result withRegistry now gets its built-in and package components from RegistrarInterface providers (SPI) when it is first_register.php files that Composer includes. A component registered withRegistry::register*() before that first lookup wins over a provider's, one registered with $clobber always wins,tbachert/spi Composer plugin in config.allow-plugins for this to take effect, without it the components areRegistrarInterface, for packages to register exporter factories, transport factories and propagators with theRegistry through SPI. Declare it with extra.spi-config.autoload-files or extra.spi. It is a bridge for SDK 1.xRegistry (#2120).InMemoryExporter accepts an AggregationTemporalitySelectorInterface, such as TemporalityPreference, as itsInstrumentType::GAUGE is no longer experimental. The synchronous Gauge is stable in the specification (#2129).Temporality or a string as the temporality of ConsoleMetricExporter or InMemoryExporter. Pass aTemporalityPreference::cumulative() or TemporalityPreference::delta(). The delta preferenceTemporality::DELTA made them delta. AnTemporalityPreference::cumulative() to get that now (#2129).MetricMetadataInterface::temporality() and MetricStreamInterface::temporality(). Choose temporality bytbachert/spi plugin running, the SDK finds the OTLP factories whilesdk/_autoload.php builds its providers. It used to build them before exporter-otlp/_register.php could registerSpan exporter factory not defined for: otlpOTEL_CONFIG_FILE (Transport factory not defined for protocol: http) (#2120).AutoRootSpan::start($notifySpanEnded) registers the callback also when the root span was already started, forSdkAutoloader::autoload(). The callback used to be dropped. A callback that throws no longer keeps theth rejection threshold exactly, with the precision recommended by the1/3 was th:aaaaaaaaaaaaac instead of th:aaab, 0.1 was th:e6666666666666 instead ofth:e666 (#2140).Full Changelog: 1.16.1...1.17.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
The host detector ran ioreg, kenv and powershell.exe through a shell, so they were looked up on PATH, and on Windows in the current directory. A progr
ioreg, kenv and powershell.exe through a shell, so they were
looked up on PATH, and on Windows in the current directory. A program placed there ran
instead. It runs /usr/sbin/ioreg, /bin/kenv and reg.exe by absolute path, without a
shell (GHSA-fc6f-cp96-6g5w).host.id was "" on macOS and Windows, or /bin/kenv on
BSD. It is left out instead (GHSA-fc6f-cp96-6g5w).Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.16.0...1.16.1
OTEL_CONFIG_FILE names one file. It used to be split on commas for instrumentation config ([#2105]).
OTEL_CONFIG_FILE names one file. It used to be split on commas for instrumentation config
(#2105).symfony/polyfill-php82 (#2091).open-telemetry/api 1.11, for Logging::setLogLevel() (#2068).open-telemetry/sem-conv 1.45, for HttpIncubatingAttributes::HTTP_REQUEST_BODY_CONTENT
(#2101).Accept-Encoding header in the exporter headers, only gzip responses are decoded.
The discovered Guzzle client used to decode responses, and no longer does, so the body of a response
in another encoding, such as deflate or zstd, is ignored with a warning. Without that header the
SDK asks for an uncompressed response (#2115, #2112).PsrTransport only decodes gzip responses (also as x-gzip). The body of a successful response
that can't be decoded, such as a deflate or br one that the specification doesn't mention, is
ignored with a warning (#2112).OTEL_PHP_EXCLUDED_REQUEST_HEADERS disables the SDK for web requests that have a matching
header, like OTEL_PHP_EXCLUDED_URLS does for a URL, for example
User-Agent: kube-probe*,X-Skip-Tracing. Entries are name: value or name, the name ignores
case and treats _ as -, and the value takes * wildcards. A value cannot contain a comma,
and a header sent more than once is matched as one value joined with , . Headers are read from
$_SERVER and are set by the client, so use a header that a trusted proxy sets or removes if
clients must not be able to opt out. It is evaluated when the SDK autoloads, so it needs an
autoload per request and does not work in workers that autoload once at boot (#2113).OpenTelemetry\SDK\Trace\Sampler\Consistent, led by
CompositeSampler. All are experimental (#2077).METHOD path, grouped by OTEL_PHP_TRANSACTION_URL_GROUPS. It
captures the headers named in OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_REQUEST_HEADERS and
OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_RESPONSE_HEADERS, and sets
http.response.status_code. OTEL_PHP_TRANSACTION_SPAN_ENABLED turns it on, and
OTEL_PHP_TRANSACTION_SPAN_ENABLED_CLI adds a root span for CLI scripts. New
AutoRootSpan::start() (#2080).OTEL_METRICS_EXEMPLAR_FILTER accepts always_on, always_off and trace_based, and defaults
to trace_based. all, none and with_sampled_trace still work (#2057).RandomTraceIdGeneratorInterface. Root spans from a generator that implements it, such as
RandomIdGenerator, get the W3C random trace flag (#2092).TemporalityPreference, an AggregationTemporalitySelectorInterface that picks temporality per
instrument kind (#2095), and TemporalityPreference::fromName() (#2105).DropAggregation, InstrumentUnitCriteria, ViewTemplate::withAggregationResolver(), and
recordMinMax on ExplicitBucketHistogramAggregation (#2093).ViewTemplate::withAttributeKeyFilter(), which keeps attribute keys by * and ? patterns.
Excluded wins (#2095).ConsoleMetricExporter accepts an AggregationTemporalitySelectorInterface and a
TransportInterface (#2095).SdkBuilder::setLogLevel(), applied by buildAndRegisterGlobal() until its scope is detached
(#2068).OTEL_PHP_INSTRUMENTATION_HTTP_SERVER_CAPTURE_REQUEST_BODY makes the auto root span record the
request body as http.request.body.content, cut at
OTEL_PHP_INSTRUMENTATION_HTTP_SERVER_CAPTURE_REQUEST_BODY_MAX_SIZE bytes (1024 by default).
It is off by default, records only textual bodies, and does not redact them (#2101).OTEL_CONFIG_FILE, or one set without open-telemetry/sdk-configuration
installed, logs a warning and leaves the SDK as noop. It used to throw (#2076).OTEL_CONFIG_FILE as the SDK. This needs
open-telemetry/sdk-configuration 0.10. An older one logs a warning and instrumentation gets no
config (#2076).OTEL_RESOURCE_ATTRIBUTES logs a warning and is discarded in full. It used to
throw, which left the SDK as noop (#2105).OTEL_RESOURCE_ATTRIBUTES or
OTEL_EXPORTER_OTLP_HEADERS is skipped. An entry with an empty key is an error (#2105).BatchSpanProcessor and BatchLogRecordProcessor lower a maxExportBatchSize above
maxQueueSize to the queue size, with a warning. They used to throw (#2105). They accept a
schedule delay or export timeout of 0 (#2095).TraceIdRatioBasedSampler warns once when used as a child sampler (#2105). Its description is
TraceIdRatioBased{...}, not TraceIdRatioBasedSampler{...} (#2092).AlwaysRecordSampler is no longer experimental (#2092).setException()
(#2092).Instrument::$unit and $description are strings. A null is stored as '' (#2105).ConsoleMetricExporter writes through a stream transport, and returns false if the metrics
can't be encoded. It writes NaN and infinities as "NaN", "Infinity" and "-Infinity"
(#2095).SdkDistribution and DistributionRegistry are @internal. DistributionConfiguration and
DistributionProperties are experimental (#2097).OTEL_PHP_EXPERIMENTAL_AUTO_ROOT_SPAN. Use OTEL_PHP_TRANSACTION_SPAN_ENABLED, which wins when
both are set (#2080).EventLoggerProvider, EventLoggerProviderInterface and NoopEventLoggerProvider, with the
rest of the Events API (#2092).Content-Encoding
in place, as Symfony HttpClient does, because the body was decoded again. PsrTransport now sends
Accept-Encoding: identity, so the server doesn't compress the response, and the discovered Guzzle
client no longer decodes responses (decode_content is false). A client you pass in yourself keeps
its own decoding, but gets the same Accept-Encoding header (#2115).PsrTransport limits the OTLP/HTTP response body to 4 MiB, also after decompression, as the
specification requires. A larger response is discarded with a warning and the export fails without
a retry, whatever its status, even if the server accepted the data. Decompression is streamed and
checked in small steps. The PSR-18 client may buffer the whole response before the limit applies
(#2112).OTEL_ATTRIBUTE_COUNT_LIMIT and OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT were ignored. They apply to
span, event, link and log record limits that aren't set more specifically (#2058).PsrTransportFactory ignored its cacert, cert and key arguments. It passes them to the
HTTP client (#2060). A client that rejects them is created without them, with a warning, and
Symfony HttpClient no longer rejects them (#2095).OTEL_PHP_TRANSACTION_URL_GROUPS matched texts it should not: a
pattern with several * accepted its parts in the wrong order (*health*probe* matched
client/probe/health) and the last part could overlap an earlier one (ab*bc matched abc)
(#2113).Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.15.0...1.16.0
Avoid collecting unsanitized process arguments by @PuvaanRaaj in 1993
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.14.0...1.15.0
chore: Fixed phpstan errors by @jerrytfleung in 1911
What's Changed:
Full Changelog: 1.13.0...1.14.0
Update open-telemetry/api version to ^1.8 by @nolanpro in 1882
What's Changed:
Full Changelog: 1.12.0...1.13.0
generate semconv 1.38.0 by @brettmc in 1855
What's Changed:
Logger::logRecordBuilder() by @Nevay in 1859AlwaysRecordSampler by @vitorvasc in 1836Full Changelog: 1.11.0...1.12.0
Disable SDK from autoloading during composer execution. by @ChrisLightfootWild in 1727
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.10.0...1.11.0
What's Changed:
Full Changelog: 1.10.0...1.11.0
feat: Implement onEnding interface of Span Processor in Trace SDK by @jerrytfleung in 1785
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.9.0...1.10.0
Implement span suppression strategies by @Nevay in 1599
What's Changed:
Full Changelog: 1.8.0...1.9.0
feat: Add experimental response propagator interface by @jerrytfleung in 1712
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.7.1...1.8.0
What's Changed:
Full Changelog: 1.7.1...1.8.0
Allow installing SDK with API v1.5 by @IonBazan in 1708
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.7.0...1.7.1
Fix psalm regressions. by @ChrisLightfootWild in 1680
What's Changed:
Full Changelog: 1.6.0...1.7.0
add Logger.Enabled event name parameter by @brettmc in 1632
Update TraceIdRatioBasedSampler to calculate sampling threshold according to OTEP 235 by @Nevay in 1391
stabilize logger.enabled by @brettmc in 1580
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.3.0...1.4.0
deprecate filtered attributes and reference by @ycchuang99 in 1565
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.2.4...1.3.0
Refactor InMemory exporters to use shared storage manager by @GrzegorzDrozd in 1559
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.2.3...1.2.4
Fix missing metrics attributes in console exporter by @GrzegorzDrozd in 1558
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.2.2...1.2.3
handle empty meter observers by @brettmc in 1490
declarative config 0.3+ support by @brettmc in 1452
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.2.0...1.2.1
deprecate event logger by @brettmc in 1466
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.1.2...1.2.0
Fix start timestamp in auto root span by @znerol in 1413
Add TextMapPropagator to instrumentation context by @Nevay in 1401
What's Changed: Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.1.0beta3...1.1.0
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.1.0beta3...1.1.0
improve excluded urls code by @brettmc in 1227
Adding 'all' as an option for disabling auto instrumentations by @joaojacome in 1220
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.6...1.0.7
update proto to 1.1.0 by @brettmc in 1215
Add support for multi-instrument callbacks by @Nevay in 1202
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.4...1.0.5
Fix delta storage failing to merge node under rare circumstances by @Nevay in 1201
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.3...1.0.4
Add Jaeger Propagator by @weslenteche in 1188
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.2...1.0.3
Add instrument advisory parameter by @Nevay in 1186
Rename XCloudTrace to CloudTrace by @ynikitin-etsy in 1142
update semconv to 1.22.0 by @brettmc in 1126
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
Update SPI dependency. by @ChrisLightfootWild in 1388
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.1.0beta2...1.1.0beta3
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/sdk/compare/1.1.0beta1...1.1.0beta2
[PHP 8.4] Fixes for implicit nullability deprecation by @andypost in 1297
What's Changed:
weaken for PHP8.4 closure names by @Nevay in 1303Span::addLink() and Meter::createGauge() by @Nevay in 1289Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.8...1.1.0beta1
temporality preference from env by @brettmc in 990
What's Changed:
MeterProvider-wide registry by @Nevay in 979Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.0beta8...1.0.0beta9
apply logging spec updates by @brettmc in 977
documenting logs bridge api, adding memory exporter by @brettmc in 959
Ensure base64 encoded values can be used as headers from env by @cedricziel in 943
What's Changed:
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.0beta5...1.0.0beta6
open stream failure by @pdelewski in #940
Full Changelog: https://github.com/opentelemetry-php/sdk/compare/1.0.0beta4...a.b.c
adding logs signal by @brettmc in #934
Full Changelog: https://github.com/opentelemetry-php/sdk/commits/1.0.0beta3
Full Changelog: https://github.com/opentelemetry-php/sdk/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/sdk/compare/1.0.0beta15...1.0.0beta16
One column per quarter.