OpenTelemetry PHP Distro is a distribution of OpenTelemetry PHP. It inherits OpenTelemetry compatibility and extends runtime features with native components.
Auto-instrumentation captures telemetry for supported frameworks and libraries, but it does not instrument:
- proprietary or custom framework internals
- closed-source components without instrumentation hooks
- application-specific business logic
For unsupported areas, use manual OpenTelemetry instrumentation.
Supported PHP versions: 8.1 to 8.4.
php-cliphp-fpmphp-cgi/fcgimod_php(prefork)
- Linux
- Architectures:
x86_64,arm64 - glibc-based systems:
deb,rpm - musl-based systems (Alpine):
apk
- Architectures:
- Laravel
6.xto11.x - Slim
4.x
- cURL
- HTTP async (
php-http/httplug) - MySQLi
- PDO
- PostgreSQL
| Name | Included from distro version | Package |
|---|---|---|
| curl | 1.0 | open-telemetry/opentelemetry-auto-curl |
| http-async-client | 1.0 | open-telemetry/opentelemetry-auto-http-async |
| laravel | 1.0 | open-telemetry/opentelemetry-auto-laravel |
| mysqli | 1.0 | open-telemetry/opentelemetry-auto-mysqli |
| pdo | 1.0 | open-telemetry/opentelemetry-auto-pdo |
| postgresql | 1.2 | open-telemetry/opentelemetry-auto-postgresql |
| slim | 1.0 | open-telemetry/opentelemetry-auto-slim |
- Automatic root span creation
- Root span URL grouping
- Inferred spans
- Background telemetry sending
Background sending (non-blocking export) works with OTLP http/protobuf (default). If exporter/protocol changes to unsupported transport (for example gRPC), export becomes synchronous.