• ログイン無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

newrelic_create_distributed_trace_payload (PHPエージェントAPI)

構文

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メソッドの使用方法やタイミングの例については、 手動で計測するアプリケーションやサービスのドキュメントを参照してください

Copyright © 2022 New Relic Inc.