構文
newrelic_create_distributed_trace_payload()分散型トレースのペイロードを作成します。
要件
Requires PHP agent version 8.4 or higher.
説明
分散トレース では、リクエストが分散システムを通過する際のパスを確認することができます。
重要
PHP エージェント バージョン 9.10 または 以上では、以下の JSON 関数が非推奨とされ、将来のリリースで削除される予定です。
newrelic_create_distributed_trace_payload()newrelic_accept_distributed_trace_payload($payload)newrelic_accept_distributed_trace_payload_httpsafe($payload)代わりに、エージェントバージョン9.8で追加されたW3C Trace Contextのサポートと互換性のあるAPIを使用してください。これに伴い、アプリケーションを手動でインストルメントするためのAPIは、JSONペイロード関連の関数から、以下のようなヘッダー配列形式に変更されました。
newrelic_insert_distributed_trace_headers($outbound_headers)newrelic_accept_distributed_trace_headers($inbound_headers)戻り値
このメソッドはnewrelic\DistributedTracePayload.型のオブジェクトを返します このオブジェクトには、分散トレース ペイロードをテキストとしてレンダリングする 2 つのメソッドがあります。
$payload = newrelic_create_distributed_trace_payload(); // renders the payload as a JSON string$jsonText = $payload->text(); // renders the payload as an string suitable for transport via HTTP (query string, POST param, HTTP headers, etc.)$httpSafeString = $payload->httpSafe();例
このAPIメソッドの使用方法やタイミングの例については、 手動で計測するアプリケーションやサービスのドキュメントを参照してください 。