PHP zero-code instrumentation
You are viewing the English version of this page because it has not yet been fully translated. Interested in helping out? See Contributing.
OpenTelemetry provides two zero-code instrumentation approaches for PHP:
| Auto-instrumentation | PHP Distro | |
|---|---|---|
| Install | Composer + PECL extension | OS package (deb, rpm, apk) |
| Platform | Linux, macOS, Windows | Linux only |
| Setup | Composer autoloading | Install package, restart PHP |
| Control | Full manual control | Opinionated defaults |
| Best for | Flexible environments, custom config | Production Linux deployments |
Choose auto-instrumentation
Use PHP zero-code auto-instrumentation when you:
- Already use Composer
- Need to run on macOS or Windows
- Want maximum control over instrumentation and configuration
Choose PHP Distro
Use OpenTelemetry PHP Distro when you:
- Deploy to Linux and want a package-managed install (
deb,rpm,apk) - Need zero-code onboarding without touching application code or Composer
- Want production-tuned defaults (background export, inferred spans, OpAMP)
OpenTelemetry PHP Distro
Production-ready, zero-code OpenTelemetry instrumentation for PHP, delivered as native Linux packages.
Feedback
Was this page helpful?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!