注意
SignalFx Tracing Library for PHP は、2024年2月21日をもって非推奨となり、2025年2月21日にサポート終了 (EOS) となります。それまでは、重要なセキュリティ修正とバグ修正のみが提供されます。EOS の日付が過ぎると、ライブラリはアーカイブされ、保守されなくなります。
新規あるいは既存の PHP アプリケーションをインストルメンテーションしたい場合は、OpenTelemetry PHP instrumentation を使用してください。
Splunk Observability Cloud 用の PHP インストルメンテーションを設定する 🔗
以下のセクションでは、SignalFx Tracing Library for PHP の設定について説明します。
一般設定 🔗
以下の設定を使用して、SignalFx Tracing Library for PHP を設定します：
環境変数 |
説明 |
|---|---|
|
Splunk Observability Cloud のサービス名。デフォルト値は |
|
エンドポイントURL。デフォルト値は |
|
トレーサーの自動作成とインストルメンテーションを有効にするかどうか。デフォルト値は |
|
|
|
デバッグロギングを有効にするかどうか。デフォルト値は |
|
B3 コンテキスト伝搬を有効にするかどうか。デフォルト値は |
|
属性値が持つことのできる最大長。これより長い値は切り捨てられます。 デフォルト値は |
|
ルート・スパンにアタッチする環境変数をカンマ区切りで列挙します。 |
|
スパンに変換する受信リクエストヘッダーのカンマ区切りリスト。例えば、 |
|
ライブラリから Splunk Observability Cloud に直接データを送信するための認証トークン。デフォルトでは設定されていません。Splunk Observability Cloud インジェストエンドポイントにデータを送信する必要がなければ不要です。詳細については、Splunk Observability Cloud に直接データを送信する を参照してください。 |
CLIセッションのトレース 🔗
CLI SAPI機能をトレースするには、SIGNALFX_TRACE_CLI_ENABLED 環境変数を使用して手動で有効にする必要があります。CLIトレースを有効にすると、インストルメンテーションは自動的にルートスパンを作成し、CLIセッションのライフタイムを追跡します。
export SIGNALFX_TRACE_CLI_ENABLED=true
php artisan migrate:fresh
php myTracedCliScript.php
このSAPIは、システムアクティビティの望ましくないトレースを避けるため、デフォルトでは無効になっています。
サーバートレース情報 🔗
モバイルおよびウェブアプリケーションからのリアルユーザーモニタリング（RUM）リクエストとサーバートレース・データを接続するために、トレース・レスポンス・ヘッダーがデフォルトで有効になっています。インストルメンテーションは、HTTP レスポンスに以下のレスポンス・ヘッダーを追加します：
Access-Control-Expose-Headers: Server-Timing
Server-Timing: traceparent;desc="00-<serverTraceId>-<serverSpanId>-01"
Server-Timing ヘッダーには、traceId と spanId パラメータが traceparent 形式で含まれています。詳しくは、W3C ウェブサイトの Server-Timing と traceparent のドキュメントを参照してください。
注釈
トレース・レスポンス・ヘッダーを無効にする必要がある場合は、SIGNALFX_TRACE_RESPONSE_HEADER_ENABLED を false に設定するか、INI ファイルの signalfx.trace.response_header_enabled オプションを false に設定してください。