PHP

PHP における OpenTelemetry の言語固有の実装。

OpenTelemetry PHP のドキュメントへようこそ。 このセクションでは、OpenTelemetry の API と SDK を使い、PHP でメトリクス、ログ、トレースなどのテレメトリーデータを生成・収集する方法を紹介します。

これらのページは、OpenTelemetry PHP の利用を開始し、現在の機能とステータスを理解するための手助けとなるように作られています。

ステータスとリリース

OpenTelemetry PHPの主要な機能コンポーネントの現在のステータスは以下の通りです。

最新のリリースを含むリリース情報については、リリースをご覧ください。

参考資料

• OpenTelemetry for PHP（GitHub）
• サンプル

要件

OpenTelemetry SDK for PHP は、www.php.net/supported-versions に記載されている公式にサポートされているすべての PHP バージョンをサポートすることを目標としており、PHP バージョンの End of Life から12か月以内にサポートが終了します。

自動計装には PHP バージョン 8.0 以上が必要です。

依存関係

SDK および Contrib パッケージの一部は、HTTP Factories (PSR-17) と php-http/async-client の両方の実装に依存しています。 適切な composer パッケージは packagist.org で見つけられます。

PSR-17 (HTTP factories) 実装は http-factory-implementations を、php-http/async-client 実装は async-client-implementations を参照してください。

オプションの PHP エクステンション

ext-ffi

Fiber のサポートは、環境変数 OTEL_PHP_FIBERS_ENABLED を true に設定することで有効にできます。 非 CLI SAPI で Fiber を使用する場合、バインディングのプリロードが必要になることがあります。 これを実現する方法の1つは、ffi.preload を src/Context/fiber/zend_observer_fiber.h に、opcache.preload を vendor/autoload.php に設定することです。

ext-protobuf

ネイティブ protobuf ライブラリはエクステンションに比べて大幅に遅くなります。 エクステンションの使用を強く推奨します。

セットアップ

OpenTelemetry for PHP は packagist を通じて複数のパッケージとして配布されています。 必要なパッケージのみをインストールすることを推奨します。 最低限、通常は API、Context、SDK およびエクスポーターが必要です。

コードが依存するのは API パッケージのクラスとインターフェイスのみにすることを強く推奨します。