OpenTelemetry PHP Distro のセットアップ

OpenTelemetry PHP Distro を使用して PHP アプリケーションを計装し、OTLP 互換バックエンドにテレメトリーデータを送信する方法を学びます。

前提条件

• テレメトリーデータの送信先（OTLP エンドポイント）があること。
• サポートされている Linux ディストリビューションと PHP バージョンを使用していること。
• 同じプロセスで他の PHP APM や OpenTelemetry エージェントを実行していないこと。

サポートされているオペレーティングシステムと PHP バージョンについては、サポートされているテクノロジーを参照してください。

制限事項

既知のランタイムおよび互換性の制限事項については、制限事項に記載されています。

パッケージのダウンロードとインストール

GitHub Releases ページからプラットフォームに合ったパッケージをダウンロードしてインストールします。

RPM（RHEL/CentOS/Fedora）

sudo rpm -ivh <package-file>.rpm

DEB（Debian/Ubuntu）

sudo dpkg -i <package-file>.deb

APK（Alpine）

sudo apk add --allow-untrusted <package-file>.apk

エクスポーターの設定

最低限、以下を設定してください。

• OTEL_EXPORTER_OTLP_ENDPOINT
• OTEL_EXPORTER_OTLP_HEADERS

例:

export OTEL_EXPORTER_OTLP_ENDPOINT="https://your-otlp-endpoint:443/"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer <token>"

PHP プロセスの再起動

インストールと設定が完了したら、PHP プロセス（たとえば php-fpm、Apache ワーカー、長時間実行される CLI ワーカー）を再起動して、エクステンションをロードします。

テレメトリーの確認

1. オブザーバビリティバックエンドを開きます。
2. トレースからサービスを探します。
3. トレースがまだ表示されない場合は、トラフィックを生成してください。

トラブルシューティング

• 設定で設定オプションを確認してください。
• 制限事項で既知の制約を確認してください。
• Laravel Octane（Swoole または RoadRunner）を使用している場合は、長時間実行 PHP サーバーを参照してください。