構文
newrelic_insert_distributed_trace_headers (array $headers)
W3C Trace Context ヘッダと New Relic Distributed Tracing ヘッダを、送信するヘッダの配列に挿入します。
要件
Requires PHP agent version 9.8 or higher.
説明
newrelic_insert_distributed_trace_headers
を使って、手動でアウトバウンド・ヘッダーの配列に分散型トレーシング・ヘッダーを追加します。
Distributed Tracing が有効な場合、 newrelic_insert_distributed_trace_headers
は常に W3C トレースコンテキストヘッダーを挿入します。また、デフォルトでは New Relic Distributed Tracing ヘッダも挿入されますが、これは newrelic.distributed_tracing_exclude_newrelic_header
INI の設定で無効にすることができます。
パラメータ
パラメーター | 説明 |
---|---|
アレイ | 必要です。アウトバウンドヘッダーの(任意で空の)配列です。この引数は参照によって渡されるため、リテラルではなく変数である必要があります。 |
戻り値
与えられた配列へのヘッダの挿入に成功した場合は True
、そうでない場合は False を返します。
例
このAPIメソッドの使用方法やタイミングの例については、 手動で計測するアプリケーションやサービスのドキュメントを参照してください 。