トレースの詳細の表示

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

トレースの詳細の表示

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

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

  2. トレースに関する詳細情報を表示する方法はいくつかあります。

    • テーブルに表示されている URI をクリックする。
    • グラフ内の点をクリックする。
    • [選択したトレースの詳細] ビューに、トレース ID を 16 進数形式で入力します。トレース ID を入力すると、Selected trace may not match current filters または Selected trace is outside the current time range というメッセージが表示されることがあります。これらの情報メッセージは、表示されるトレースが、フィルタまたは期間設定と一致していないことを示しています。

選択したトレースの詳細ペイン

調査対象のトレースを選択すると、選択したトレースの詳細が表示されます。

  • [選択したトレースの詳細] テキスト ボックスには、そのトレースの ID が表示されます。

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

  • ペインには、一連の表にウォーターフォール グラフでハイライト表示されたスパンの詳細情報が表示されます。

これらのフィールドは、調査するトレースを選択するたびに新しいデータで更新されます。次のスクリーンショットは、これらのペインを示しています。

Cloud Trace の詳細ペイン

ウォーターフォール グラフ

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

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

    サービスが複数のクロックソースまたは異なる言語ライブラリを利用しているときは、タイムスタンプの不整合が発生する可能性があります。

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

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

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

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

[イベントを表示] チェックボックス

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

クリックしてコピー

コピー をクリックすると、特定トレースの詳細ビューの URL をクリップボードにコピーできます。

スパンの詳細を含むテーブル

これらのテーブルには、現在ウォーターフォール グラフでハイライト表示されている行に関する詳細情報が含まれます。ウォーターフォール グラフの各行は、トレーススパンに対応しています。

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

表に表示されるデータは、ハイライト表示された要素により変わります。ただし、次の表に示すデータは常に表示されます。

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

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

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

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

ルートスパンがハイライト表示され、リクエストが HTTP リクエストの場合は、[概要] というテーブルが表示されます。テーブルには、ルートスパンの行と、RPC ごとに 1 行があります。

概要テーブル
説明
名前 RPC 呼び出しの名前。形式は service_name.call_name です。スパンのラベルに表示されます。
RPC 数 手続きが呼び出された回数。
合計時間 RPC で費やされる合計時間。

[詳細] というテーブルには、スパンに関するメタデータが一覧表示されます。常に表示されるプロパティを次に示します。

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

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

スパン ID このフィールドを表示するには、[詳細] メニュー をクリックします。

スパンの ID。この ID は、0 以外の 64 ビットの整数です。詳細については、TraceSpan を参照してください:。

GKE コンテナ

このテーブルが表示される場合、スパンには GKE コンテナの正規ラベルが含まれます。テーブル内の各行は、特定のラベルに対応するもので、値はリソースに関する情報をより詳しく表示するために使用できるリンクです。すべてのラベルの詳細については、トレースラベルをご覧ください。

ラベルとその意味を次の表に一覧で示します。

ラベル
Project ID GKE クラスタをホストする Google Cloud プロジェクト。プロジェクト名をクリックして、Google Cloud Console の GKE ダッシュボードに移動します。
Cluster Name GKE クラスタを識別します。この値をクリックして、[クラスタ] 構成ページに移動します。
Namespace 名前空間を識別します。この値をクリックして、GKE の [ワークロード] ページに移動します。
Pod Name GKE Pod を識別します。この値をクリックして、Pod の詳細ダッシュボードに移動します。
Container Name GKE コンテナを識別します。この値をクリックして、コンテナの詳細ページに移動します。
ラベル リクエスト内のラベルと値のテーブル。ラベルはアプリケーション固有です。すべてのラベルの詳細については、トレースラベルをご覧ください。

次の表に、いくつかの一般的なラベルとその意味を示します。

ラベル
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 を選択すると、その詳細が[詳細] ペインに表示されます。

次のステップ