構文
newrelic_accept_distributed_trace_payload_httpsafe(string $httpsafe_payload, string $transport_type)
HTTPSafe(Base64エンコード)のJSON文字列を含む分散型トレースペイロードを受け取ります。
要件
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)
パラメーター
パラメータ | 説明 |
---|---|
ストリング | 必要です。ペイロードのHTTPSafe(Base64エンコードされた)JSON文字列表現。 |
ストリング | オプションです。デフォルトのトランスポート・タイプを上書きする文字列です。 デフォルト値です。
|
戻り値
成功を示す場合はtrue
を返し、エラーが発生した場合はfalse
を返します。
例
このAPIメソッドの使用方法やタイミングの例については、 手動で計測するアプリケーションやサービスのドキュメントを参照してください 。