トレースの詳細の表示

Cloud Trace では、[トレースリスト] ページの [トレースの詳細] ペインにトレースの詳細が表示されます。このビューには、リクエストに関する詳細の概要、リクエストを表すルートスパンと RPC コールを表すサブスパンのグラフィカルなタイムライン、スパンに関して収集されたレイテンシ データの詳細ビューが表示されます。

トレースの詳細の表示

  1. Cloud Console で、[トレースリスト] ページに移動します。

    [トレースリスト] に移動

  2. トレースに関する詳細情報を表示するには、次の 2 つの方法があります。

    • テーブルに表示されている URI をクリックする。
    • グラフ内の点をクリックする。

スケジュール

調査するトレースを初めて選択すると、[トレースリスト] ページに 2 つの新しいペインが表示されます。

  • 新しいペインの 1 つに、ウォーターフォール グラフを使用してリクエストのレイテンシ データの図が表示されます。デフォルトでは、選択したトレースのルートスパンがハイライト表示されます。

  • 新しいもう 1 つのペインには、ウォーターフォール グラフでハイライト表示された行に関する詳細情報が表示されます。

この 2 つのペインは、調査するトレースを選択するたびに新しいデータで更新されます。

Cloud Trace の詳細ペイン。

ウォーターフォール グラフの各行は、トレースのスパンに対応しています。

  • 記号が表示されている場合は、Cloud Trace により、親の開始時間よりも開始時間が前にあるスパンが検出されました。Cloud Trace では、スパンの表示時にこの不一致は自動的に補正されますが、スパンデータは変更されません。

    サービスが複数のクロックソースまたは異なる言語ライブラリに依存している場合、タイムスタンプの不整合が生じる可能性があります。

  • 記号が表示されている場合は、スパンに HTTP エラーが含まれていることを示します。

  • RPC 呼び出しの名前。形式は service_name.call_name です。例: datastore_v3.RunQuery

    App Engine スタンダード環境では、ここで通知される内部名が言語固有のサービス API の名前と一致しないことがあります。

  • 往復 RPC コールが完了するまでにかかった時間。

[イベントを表示] をクリックすると、ウォーターフォール グラフが再描画され、イベントの注釈がグラフの行として表示されます。注釈の詳細については、スパンに注釈をつけるをご覧ください。

スパン詳細ペイン

ウォーターフォール グラフの隣にあるのは、スパン詳細ペインです。このペインには、ウォーターフォール グラフでハイライト表示された行に関する詳細情報が表示されます。表示されるデータは、ハイライト表示されている要素によって異なります。

スパンをハイライト表示する場合、詳細にはスパンの URI 名と相対的な開始時間、RPC コールの名前が含まれます。

特性 説明
相対的な開始時間 最初の項目は、スパンの相対的な開始時間です。

ルートスパンの場合、この値は常に @0 ms です。

サブスパンの場合、リクエストの開始に対してサブスパンが開始された相対時間です。つまり、この値は、この RPC 呼び出しが開始されるまでの全体的なリクエストの開始からの経過時間を示します。
名前 次の項目は RPC 呼び出しの名前です。名前の形式は service_name.call_name です。たとえば、datastore_v3.RunQuery です。

App Engine スタンダード環境では、ここで通知される内部名が言語固有のサービス API の名前と一致しないことがあります。

ルートスパンがハイライト表示されると、次のエントリは [概要] テーブルになります。テーブルにはルートスパンの行と、サブスパンによって呼び出される各 RPC の 1 つの行があります。

概要テーブル
説明
名前 RPC 呼び出しの名前。形式は service_name.call_name です。スパンのラベルに表示されます。
RPC 数 プロシージャが呼び出された回数。
合計時間 RPC の実行にかかった合計時間。

ペインの最後のエントリは [詳細] テーブルです。このテーブルでは、スパンに関するメタデータが表示されます。常に表示されるプロパティを次に示します。

詳細テーブル
プロパティ
説明
タイムスタンプ アプリケーションがリクエストを受信した時刻。
ログ ログデータがある場合はログエントリへのリンク。ログデータがない場合、この行は省略されます。
報告 このトレースを含む最新の分析レポートへのリンク。このトレースを含むレポートがない場合、この行は省略されます。
トレース ID
(プレビューの [トレースリスト] ページでのみ使用可能)
このフィールドを表示するには、[詳細] メニュー をクリックします。

トレースのグローバルに一意の識別子。この識別子は、32 バイトの 16 進文字列で表される 128 ビットの数値形式です。詳細については、Resource: Trace をご覧ください。

スパン ID
(プレビューの [トレースリスト] ページでのみ使用可能)
このフィールドを表示するには、[詳細] メニュー をクリックします。

スパンの識別子。この識別子は 0 以外の 64 ビットの整数です。詳細については、TraceSpan をご覧ください。

ラベル リクエスト内のラベルと値のテーブル。ラベルはアプリケーション固有です。次の表に、いくつかの一般的なラベルとその意味を示します。
http/host アプリケーションが動作しているホスト名。
http/response/size HTTP レスポンスの本文のバイト数。
http/url リクエストの相対 URL。
gae/request_log_id 内部 App Engine リクエスト ID。

リクエスト タイプが HTTP の場合や、アプリケーションが App Engine で実行されている場合は、追加のプロパティが表示されることがあります。次の表に、よく使用されるプロパティの一部を示します。

特性 説明
トレースされた時間 (HTTP のみ)すべての RPC コールがそれぞれ完了するまでにかかった時間の合計。
トレースなしの時間 (HTTP のみ)RPC コールが行われていない時間。つまり、アプリケーションでローカルに使用された時間が測定されます。負荷に対処するために新しいインスタンスが作成されると、リクエストの開始時にトレースされない時間が長くなることがあります。
HTTP メソッド (HTTP のみ)リクエストの HTTP メソッド。
サービス (App Engine のみ)リクエストを処理した App Engine サービス。詳細については、App Engine をご覧ください。
バージョン (App Engine のみ)リクエストを処理したアプリケーションのバージョン。

イベントをハイライト表示すると、イベントの詳細が詳細ペインに表示されます。デフォルトでは、イベントはウォーターフォール グラフに表示されません。ウォーターフォール グラフに追加するには、[イベントを表示] をクリックします。

分析情報

リクエストのパフォーマンスに関する分析情報が利用可能な場合は、タイムラインの下に表示されます。

詳細については、分析情報をご覧ください。

スパンに注釈を付ける

Cloud Trace API v1 または Cloud Trace API v2 を使用することで、トレースに注釈を付けることが可能です。このセクションでは、利用可能なさまざまな選択肢について説明します。

トレースを Cloud Logging LogEntry オブジェクトに関連付けるには、アノテーションを使用します。Cloud Trace と Cloud Logging の統合の詳細については、Cloud Logging との統合をご覧ください。

ラベルによる注釈

Cloud Trace API v1 の patchTraces を使用するときは、labels オブジェクトを作成して TraceSpan オブジェクトにアタッチすることにより、注釈をスパンに追加できます。

これらのアノテーションは、トレースの詳細を表示するときにラベルとして表示されます。ラベルの詳細については、トレースラベルをご覧ください。

属性による注釈

Cloud Trace API v2 の batchWrite を使用するときは、attributes オブジェクトを作成して Span オブジェクトにアタッチすることにより、スパンに注釈を付けることができます。

これらのアノテーションは、トレースの詳細を表示するときにラベルとして表示されます。詳しくは、このページのトレースの詳細表示をご覧ください。

タイムイベントによる注釈

Cloud Trace API v2 の batchWrite を使用するときは、TimeEvents オブジェクトを作成して Span オブジェクトにアタッチすることにより、注釈とメッセージ イベントをスパンに追加できます。

TimeEvents オブジェクトは TimeEvent オブジェクトの配列で、各オブジェクトにはメッセージ イベントと注釈が含まれます。

トレースの TimeEvents を表示するには、トレースのウォーターフォール グラフに移動して [イベントを表示] をクリックします。TimeEvent を選択すると、その詳細が[詳細] ペインに表示されます。

次のステップ