OpenTelemetry for PHP

This is the monorepo for the main components of OpenTelemetry for PHP.

Documentation

Please read the official documentation: https://opentelemetry.io/docs/instrumentation/php/

API Documentation is available here: https://open-telemetry.github.io/opentelemetry-php/

AI Assistance

If you're planning on using AI to contribute to the OpenTelemetry PHP repositories, please follow the OpenTelemetry GenAI Policies.

Packages and versions

| Package | Latest | |----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | API | | | SDK | | | Context | | | Semantic Conventions | | | OTLP Exporter | | | gRPC Transport | | | OTLP Protobuf Files | | | B3 Propagator | |

Releases for both this repository and contrib are based on read-only git subtree splits from our monorepo. You should refer to packagist.org for all packages, their versions and details.

You can also look at the read-only repositories, which live in the opentelemetry-php organization.

Contributing

We would love to have you on board, please see our Contributing README

Emeritus

• Ago Allikmaa, Approver
• Amber Sistla, Triager
• Beniamin, Triager
• Cedric Ziel, Approver
• Fahmy Mohammed, Triager
• Jodee Varney, Triager
• Kishan Sangani, Triager
• Levi Morrison, Triager
• Przemyslaw Delewski, Triager
• Timo Michna, Triager

For more information about the emeritus role, see the community repository.

Specification conformance

We attempt to keep the OpenTelemetry Specification Matrix up to date in order to show which features are available and which have not yet been implemented.

If you find an inconsistency in the data in the matrix, please let us know in our slack channel and we'll get it rectified.

Backwards compatibility

See compatibility readme.

Versioning

OpenTelemetry for PHP aims to support all officially supported PHP versions according to https://www.php.net/supported-versions.php, and support will be dropped for PHP versions within 12 months of that version going End of life.

Versioning rationale can be found in the Versioning Documentation