Skip to content

PHP

The agent traces PHP 7.0 through 8.x applications on Linux (host PHP-FPM) and Docker. It does not apply on Windows.

When you instrument a PHP service, the agent attaches tracing to it automatically, with no application code changes. It reloads the PHP process manager gracefully, so requests keep being served. If tracing fails to load, it rolls back. If a PHP build is not supported, the agent skips it and tells you why.

The agent produces route-level server spans, database spans (for example, PDO calls), and error spans. It propagates W3C trace context (traceparent), so a PHP span shares its trace identifier with eBPF monitoring and with any upstream or downstream service.

The overhead is small: a fixed cost of roughly 1.6 milliseconds per request, which is a low single-digit percentage on realistic requests.

In Docker, the agent instruments PHP containers without a redeploy, and matches the container’s PHP build automatically. The instrumented application sends its traces to the agent through the container’s host gateway. See Docker platform notes for the container details.