PHP

A language-specific implementation of OpenTelemetry in PHP.

这是 OpenTelemetry PHP 的文档。 OpenTelemetry 是一个可观测性框架，这个框架提供了 API、SDK 以及一系列工具，用于辅助生成以及收集应用程序的遥感数据，比如指标（metrics）、日志（logs） 和链路追踪（trace），通过本文档，你会了解如何开始使用 OpenTelemetry PHP。

状态以及版本发布

OpenTelemetry PHP 的当前主要功能组件状态如下：

我们可以在 Releases 中找到所有已发布的版本，包括 latest release。

Further Reading

• OpenTelemetry for PHP on GitHub
• Examples

Requirements

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

Auto-instrumentation requires PHP version 8.0+.

Dependencies

Some of the SDK and Contrib packages have a dependency on both a HTTP Factories (PSR-17) and a php-http/async-client implementation. You can find appropriate composer packages implementing given standards on packagist.org.

See http-factory-implementations to find a PSR-17 (HTTP factories) implementation, and async-client-implementations to find a php-http/async-client implementation.

Optional PHP extensions

ext-ffi

Fibers support can be enabled by setting the OTEL_PHP_FIBERS_ENABLED environment variable to true. Using fibers with non-CLI SAPIs may require preloading of bindings. One way to achieve this is setting ffi.preload to src/Context/fiber/zend_observer_fiber.h and setting opcache.preload to vendor/autoload.php.

ext-protobuf

The native protobuf library is significantly slower than the extension. We strongly encourage the use of the extension.

Setup

OpenTelemetry for PHP is distributed via packagist, in a number of packages. We recommend that you install only the packages that you need, which as a minimum is usually API, Context, SDK and an exporter.

We strongly encourage that your code only depend on classes and interfaces in the API package.