NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #908 most downloaded on Packagist
PHP APM Client
Latest stable
1.27.1
Last release 13 days ago
06 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
233 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
This release fixes a memory leak in the tracer, specifically affecting version `0.99.0`
This release fixes a memory leak in the tracer, specifically affecting version 0.99.0
The next release will be version 1.0 and remove deprecated and some unused code and APIs.
⛔ This release has a memory leak in the tracer parts. A fix was released with version 0.99.1 and we encourage you to upgrade.
Windows x64 support is officially GA (generally available).
Some performance work has been undertaken to primarily reduce the overhead of telemetry reporting. The next release will be version 1.0 and remove deprecated and some unused code and APIs.
nts-ndebug vs zts-ndebug) #2536Your coding agent can read these notes before it upgrades. Set up the MCP server →
Always include the whole of src/ in the Windows and PECL build
Handle Apache graceful restarts more accurately #2483
This release includes Windows dlls for the tracer starting with PHP 7.2. #2230
Windows support is in beta. We recommend carefully deploying the tracer to staging environments and testing it there before putting it to production. We are looking towards stabilizing Windows quickly, so any feedback and issue reports are welcome.
datadog.trace.log_level allows more fine-grained control over logging (error, warn, info, debug, trace). It follows the RUST_LOG standard. Note that datadog.trace.debug still takes precedence if set.datadog.trace.log_file allows specifying a dedicated target file for any datadog trace logs instead of the default php error location.attempts in LaravelQueueIntegration #2485This release requires System INIs to be used to configure the profiler settings which control the enabling/disabling of individual features. If you are configuring the profiler using php datadog-setup.php config set, you should be fine. We recommend switching to use the config mode of datadog-setup.php to configure profiling.
php datadog-setup.php config set --php-bin all -ddatadog.profiling.timeline_enabled=0
ahash #2479This release introduces support for the Roadrunner application server and extends threat detection and blocking on XML and JSON request payloads. Request and response payloads are now also used to expand the already existing API security features.
Add span links capabilities to the OTel API #2451
Exception profiling is now enabled by default. You can manage it using the DD_PROFILING_EXCEPTION_ENABLED environment variable or the datadog.profilin
Exception profiling is now enabled by default. You can manage it using the DD_PROFILING_EXCEPTION_ENABLED environment variable or the datadog.profiling.exception_enabled setting in the INI file. Although the DD_PROFILING_EXPERIMENTAL_EXCEPTION_ENABLED environment variable and datadog.profiling.experimental_exception_enabled INI setting still work, the new ones take precedence.
datadog.profiling.experimental_features_enabled #2385master branch #2420This release introduces support for arm64 and PHP 8.3 for appsec. Additionally, it adds schema extraction and classification to appsec, which forms th
This release introduces support for arm64 and PHP 8.3 for appsec. Additionally, it adds schema extraction and classification to appsec, which forms the foundation for API security. Finally, the appsec extension has been officially incorporated into the dd-trace-php repository and will adhere to the same versioning scheme as the tracer and profiler.
This release fixes a regression in the profiler which would make it emit profiles even though profiling is disabled.
This release fixes a regression in the profiler which would make it emit profiles even though profiling is disabled.
⛔ This release has a bug with the profiler where it produces profiles even if it's been configured to be disabled. A fix was released with version 0.9
⛔ This release has a bug with the profiler where it produces profiles even if it's been configured to be disabled. A fix was released with version 0.94.1 and we encourage you to upgrade in case you have the profiler installed but disabled.
This release adds support to OpenTelemetry so that you can use the OpenTelemetry API to generate Datadog spans. This is off by default. Enable it with the environment variable DD_TRACE_OTEL_ENABLED=1 or INI setting datadog.trace.otel_enabled=1. Please, refer to the documentation to get started. Also, the tracer now generates 128 bits trace ids by default, in an effort to match OpenTelemetry standards.
This release fixes a bug in the PDO integration (cf #2351). Please do not use previous 0.93.x versions
This release fixes a bug in the PDO integration (cf #2351). Please do not use previous 0.93.x versions
> ⛔ This release contains a bug when using PDO (cf #2351).
⛔ This release contains a bug when using PDO (cf #2351). Please use 0.93.2 instead
> ⛔ This release contains a bug where some spans would report to previous traces and an issue with the PDO integration.
⛔ This release contains a bug where some spans would report to previous traces and an issue with the PDO integration. Please use 0.93.2 instead
This release adds support for PHP 8.3 for the tracer and the profiler. Please be aware that we are currently building against PHP 8.3.0 RC3.
gc_mem_caches() #2297USE_ZEND_ALLOC=0 #2301libdatadog v5 #2299Always update enabled status on RINIT DataDog/dd-appsec-php#307
Handle UnwindExit in sandbox error reporting #2288
Do not emit a deprecated diagnostic for DD_LOGS_INJECTION #2253
This release adds experimental exception profiling to the profiler. This is off by default. Enable it with the environment variable DD_PROFILING_EXPERIMENTAL_EXCEPTION_ENABLED=1 or INI setting datadog.profiling.experimental_exception_enabled=1.
In Application Security Management, this release introduces the latest version of the WAF v1.14.0 and the latest ASM ruleset v1.8.0, as well as a fix to ensure runtime IDs reported by the remote configuration client are always valid and consistent with those reported by the Tracer.
DD_TRACE_SIDECAR_TRACE_SENDER=1 or INI setting datadog.trace.sidecar_trace_sender=1. It replaces the sending of traces through a dedicated thread.end_timestamp_ns to string compilation event #2251datadog-setup.php as the profiler is not beta anymore #2278fix: Use DD_SERVICE if available (Laravel) #2256
detect an uninitialized runtime cache #2250
:warning: Important: If you are using the profiler please update to `0.91.1` to avoid a possible crash (see #2250 for more information).
:warning: Important: If you are using the profiler please update to 0.91.1 to avoid a possible crash (see #2250 for more information).
This release adds:
datadog.trace.wordpress_enhanced_integration=1 in INI. Even more extensive span collection can be enabled through datadog.trace.wordpress_callbacks=1. Feedback is welcome - just open a new issue with your thoughts!datadog-setup.php when INI file is a symlink #2242zai_option_str and use it in config #2205, #2213This release reduces CPU overhead to collect stacks, and also reduces overhead when services are idle or partially idle. It also reduces the average amount of memory used.
end_timestamp_ns unit being set #2244This release adds logs correlation and telemetry support:
This release adds logs correlation and telemetry support:
DD_INSTRUMENTATION_TELEMETRY_ENABLED=0.DD_LOGS_INJECTION=0.This release adds timeline support to the profiler. This is off by default. Enable it with the environment variable DD_PROFILING_EXPERIMENTAL_TIMELINE
This release adds timeline support to the profiler. This is off by default. Enable it with the environment variable DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED=1 or INI setting datadog.profiling.experimental_timeline_enabled=1.
safe.directory on build package step DataDog/dd-appsec-php#276Add note about cargo in README, make debug symbols included by default for manual compilation #2110
Add support for environment variable syntax to config mode in datadog-setup.php #2050
Allocation profiling is now enabled by default. You can manage it using the DD_PROFILING_ALLOCATION_ENABLED environment variable or the datadog.profiling.allocation_enabled setting in the INI file. Although the DD_PROFILING_EXPERIMENTAL_ALLOCATION_ENABLED environment variable and datadog.profiling.experimental_allocation_enabled INI setting still work, the new ones take precedence.
Remove max payload size on remote config calls DataDog/dd-appsec-php#256
This bugfix release fixes a regression introduced in 0.87.0, causing 4xx responses from Laravel to be marked as errors.
This bugfix release fixes a regression introduced in 0.87.0, causing 4xx responses from Laravel to be marked as errors.
Add config mode to datadog-setup.php #1951
curl_setopt() in PHP 7 #2039The profiling version number is now in sync with the tracer for stable releases.
libdatadog #1984Flush socket on body limit DataDog/dd-appsec-php#233
[Tracer][YII] Do not use module property if it doesn't exist #1999
DD_TRACE_AGENT_URL DataDog/dd-appsec-php#231Fix crash by reverting "perf(profiling): speed up stack walking by using function run_time_cache" #1994. Thanks, @zeroxs for reporting.
⚠ Important: Enabling profiling on this release can crash if your code or any code dependencies use magic methods. Since this is difficult to determin
⚠ Important: Enabling profiling on this release can crash if your code or any code dependencies use magic methods. Since this is difficult to determine, we recommend avoiding this release and moving to 0.86.1 or newer.
enabled_on_cli ini setting DataDog/dd-appsec-php#182config_sync helper command DataDog/dd-appsec-php#164request_exec helper command DataDog/dd-appsec-php#196engine::subscriber rule data DataDog/dd-appsec-php#186Add hooking for abstract methods #1914
Upgrade deprecated actions and ruleset to 1.4.3 DataDog/dd-appsec-php#176
This release adds new profile types: allocation size and allocation samples. They are off by default. Enable them with the environment variable DD_PROFILING_EXPERIMENTAL_ALLOCATION_ENABLED=1 or INI setting datadog.profiling.experimental_allocation_enabled=1.
Please use version 0.84.0 or newer. This version contains a bug, sometimes leading to an infinite loop during sending of traces.
Please use version 0.84.0 or newer. This version contains a bug, sometimes leading to an infinite loop during sending of traces.
Please use version 0.84.0 or newer. This version contains a bug, sometimes leading to an infinite loop during sending of traces.
Please use version 0.84.0 or newer. This version contains a bug, sometimes leading to an infinite loop during sending of traces.
Avoid deprecated zend_atol on PHP 8.2 #1778
Profiling is now installed and enabled when --enable-profiling is passed on the installer. Previously it was installed but not enabled. This removes one step in onboarding as the environment variable DD_PROFILING_ENABLED no longer needs to be set to 1, which can be difficult in some situations. The recommended way to configure profiling is to use .ini settings, which is generally easier.
Fix span limiter not being reset in long running processes #1785
We have an issue causing span counters to not be reset properly after a flush. Thus the span limit of 1000 being reached, and then hooks not being exe
We have an issue causing span counters to not be reset properly after a flush. Thus the span limit of 1000 being reached, and then hooks not being executed anymore. This impacts long-running CLI processes only. It is advised to stay on 0.80.0 until we have released 0.81.1.
Make sampling priorities public API again #1742
Integrate with Symfony console commands #1724
Some Symfony spans may be of service unnamed-php-service instead of the proper service name. Under version 0.77.0 the behaviour is as expected.
Some Symfony spans may be of service unnamed-php-service instead of the proper service name. Under version 0.77.0 the behaviour is as expected.
php_error_docref with php_log_err DataDog/dd-appsec-php#101⚠️ The tracer and profiling packages for PHP 7 and 8 are built on CentOS 7. These packages will not run on older GNU Linux versions like CentOS 6, Deb
⚠️ The tracer and profiling packages for PHP 7 and 8 are built on CentOS 7. These packages will not run on older GNU Linux versions like CentOS 6, Debian 7, and Ubuntu 12.04.
process_id and runtime_version tags #1606.<php> to <?php #1680DD_PROFILING_EXPERIMENTAL_CPU_TIME_ENABLED to 0, off, or no.trace, which is even more verbose than debug.phpinfo() (or the equivalent command line option --ri datadog-profiling) #1606Check for datadog-profiling in startup only instead of inside a message_handler #1670. This fixes a possible crash when all of tracer, profiler and ap
Please upgrade to 0.76.2, if you get crashes with apache with versions 0.76.0 or 0.76.1.
Please upgrade to 0.76.2, if you get crashes with apache with versions 0.76.0 or 0.76.1.
Note: If you are using opcache with PHP 7.3 or newer, it is advised to skip this version in favor of 0.76.1.
Note: If you are using opcache with PHP 7.3 or newer, it is advised to skip this version in favor of 0.76.1.
As part of a major refactor of our instrumenting code, we made ourselves incompatible with JIT (it will report an error that JIT will be disabled, but still work). Additionally, with opcache active, a lot of user functions are not traceable anymore on PHP 7.3 and newer. This means that the resulting traces will be missing a lot of information.
DD_PROFILING_EXPERIMENTAL_CPU_TIME_ENABLED env var. It previously supported this functionality under a different, undocumented name.Move request-replayer from our internal deprecated repository to dd-trace-php #1600
Add configurations for retaining select query string parameters in resources and http.url #1566
Rename ini settings from datadog.appsec.rules_path to datadog.appsec.rules #74
datadog.appsec.rules_path to datadog.appsec.rules #74datadog.appsec.waf_timeout as microseconds rather than milliseconds #74Add support for memcached on PHP 8 #1558
Use -1 as uninitialized op_array_extension marker #1550 (thanks @blazarecki for the report)
Due to a subtle behaviour change in PHP 8.1.4 and PHP 8.0.18 respectively, all versions of the datadog tracer up to 0.71.0 are not compatible with PHP
Due to a subtle behaviour change in PHP 8.1.4 and PHP 8.0.18 respectively, all versions of the datadog tracer up to 0.71.0 are not compatible with PHP versions newer than PHP 8.1.4 or PHP 8.0.18.
Disable x-datadog-tags header propagation #1528
Make the legacy API a pure proxy to internal spans #1471
Query string is now not included in http.url in Nette integration and in generic web frameworks tracing.
http.url in Nette integration and in generic web frameworks tracing.Clean up generate-final-artifact.sh #1442
Do not diagnostics when ddtrace is disabled #1434
Note: the internal structure of the newly released dd-library-php-x86_64-linux-*.tar.gz archive is intended for internal use and might vary in the fut
Note: the internal structure of the newly released dd-library-php-x86_64-linux-*.tar.gz archive is intended for internal use and might vary in the future.
(PHP 5) Add zai config, internal spans, and exception handling
…migration to C code, after more than a year of deprecation. Use DD_TRACE_RESOURCE_URI_FRAGMENT_REGEX, DD_TRACE_RESOURCE_URI_MAPPING_INCOMING, and DD_T…
meta, but only add to it instead, if they don't want to lose global tags. Wrong: $span->meta = [ 'some' => 'tag' ]. Correct $span->meta['some'] = 'tag'.DD_TRACE_RESOURCE_URI_MAPPING has been dropped with the migration to C code, after more than a year of deprecation. Use DD_TRACE_RESOURCE_URI_FRAGMENT_REGEX, DD_TRACE_RESOURCE_URI_MAPPING_INCOMING, and DD_TRACE_RESOURCE_URI_MAPPING_OUTGOING instead. See resource mapping for more details.DD_TRACE_ENABLED (#1332)Prevent flushing traces of requests without actual PHP code #1327
WARNING: Resource names for “Lumen” applications will change by default to GET /actual/uri/path from the previous format GET action_name or GET App\Co
WARNING: Resource names for “Lumen” applications will change by default to GET /actual/uri/path from the previous format GET action_name or GET App\Controller@action_method. You might need to adjust your monitors and filters for the change. In order to go back to the previous behavior, instead, you can temporarily set DD_TRACE_URL_AS_RESOURCE_NAMES_ENABLED=false
WARNING: Users doing manual instrumentation using the GlobalTracer::get()->startActiveSpan() api should update to this version from 0.63.0 and 0.64.0.
WARNING: Users doing manual instrumentation using the GlobalTracer::get()->startActiveSpan() api should update to this version from 0.63.0 and 0.64.0.
One column per quarter.