トレースの検索と表示

[トレースリスト] ページでは、個々のトレースを探したり、詳細を調べたりできます。このページから、トレースのすべてのスパンの表示と検査、リクエストの概要情報の表示、各スパンの詳細情報の表示を行えます。調査するトレースを制限するには、フィルタを追加します。たとえば、レイテンシが 1 秒を超えるトレースのみを表示するフィルタを追加できます。

[トレースリスト] ページには、最大 1,000 件のトレースが保存、表示されます。

最近のトレースの表示

最近のトレースを表示するには、Google Cloud Console で [トレース]、[トレースリスト] の順に選択するか、次のボタンを使用します。

トレースリストに移動

トレースを初めて使用する場合は、トレースが表示されるまでに数分かかることがあります。 次のスクリーンショットは、このページの例を示しています。

Cloud Trace の [最近のトレース] ペイン

期間

[トレースリスト] ページには、デフォルトで直前の 1 時間のデータが表示されます。ページの上部にあるボタンを使用すると、この期間をプリセット値に変更できます。プリセットのオプションは次のとおりです。

  • 1時間
  • 6時間
  • 12時間
  • 1日
  • 2日
  • 4日
  • 7日
  • 14日
  • 30日

カスタムの期間を表示する方法は次のとおりです。

  1. 希望するカスタムの期間より長いプリセット オプションを選択します。
  2. 期間の一方の端の [トレースを選択] プロットにポインタを置き、期間のもう一方の端までポインタを水平にドラッグします。
  3. (省略可)レイテンシ値のカスタム範囲を表示するには、目的の範囲の一方の端にポインタを置き、もう一方の端まで垂直にドラッグします。

目的の期間とレイテンシ範囲が選択できるまで、この操作を繰り返すことができます。

グラフをプリセットの期間に戻すには、[リセット] をクリックします。

フィルタ

個々のトレースを検索するには、フィルタを使用します。フィルタに一致しないトレースは、ビューでは非表示になります。各フィルタを指定するには、VALUE とペアになる定義済みの OPTION を使用します。一般的な構文は次のとおりです。

[OPTION] : [VALUE]

たとえば、次のスクリーンショットは 1 つのフィルタを示しています。フィルタ オプションは RootSpan で、Recv. はフィルタ値です。このフィルタでは、ルートスパンの接頭辞が Recv. のトレースのみが表示されます。

フィルタの表示。

Recv. と完全に一致するトレースを表示するには、フィルタ値として +Recv. を使用します。完全一致を求める場合は、プラス記号 + を使用します。フィルタリング構文の詳細については、トレース フィルタをご覧ください。

複数のフィルタを追加すると、すべてのフィルタを満たすトレースのみが表示されます。

フィルタの追加

フィルタを追加する手順は次のとおりです。

  1. [トレースフィルタを追加] をクリックして、フィルタ オプションのメニューを表示し、OPTION を選択します。次のオプションを使用できます。

    • RootSpan: ルートスパン名を照合します。
    • SpanName: スパン名を照合します。
    • Method: ルートスパンに /http/method ラベルが付けられ、ラベルの値が VALUE と一致するトレースを表示します。
    • Status: ルートスパンに /http/status_code ラベルが付けられ、ラベルの値が VALUE と一致するトレースを表示します。この場合、VALUE には 301 などの特定のステータス コードや、3xx などのステータス値の範囲を含めることができます。
    • MinLatency: レイテンシが VALUE ミリ秒以上のトレースを表示します。
    • HasLabel: VALUE で指定されたラベルが 1 つ以上のスパンに表示されるトレースを表示します。
    • サービス:(App Engine のみ)サービス名が VALUE と一致するスパンを少なくとも 1 つ含むトレースを表示します。
    • バージョン:(App Engine のみ)アプリケーションのバージョンが VALUE と一致するスパンを少なくとも 1 つ以上含むトレースを表示します。

    URLLABEL: Client などのオプションが表示されることもあります。

  2. (省略可)完全一致を求める場合は、プラス記号 + を入力します。デフォルトでは、VALUE で接頭辞テストを実行して一致を判別します。フィルタ オプションの詳細については、トレース フィルタをご覧ください。

  3. 次のいずれかの方法で、フィルタ VALUE を指定します。

    • [VALUE] メニューから選択します。値メニューのオプションは、完全なものであるとは限りません。
    • 手動で値を入力し、キーボードの return キーを押します。

たとえば、HTTP POST コマンドを含み、レイテンシが少なくとも 2 秒以上のすべてのトレースを表示するには、値が 2000 のオプション MinLatency でフィルタを追加します。

フィルタの編集

フィルタ値を編集するには、チップをダブルクリックしてフィルタ値の上にポインタを置きます。

  • フィルタ値のメニューから別の値を選択できます。
  • テキストを消去できます。
  • テキストを入力できます。

フィルタの値が変更されると、フィルタのスタイルが少し変更されます。

レイテンシ グラフ

トレースを選択」というラベルの付いたグラフには、選択した期間内に各リクエストのドットが表示されます。リクエストの(x、y)座標は、リクエストの時間とレイテンシに対応しています。

ドットの上にポインタを置くと、日付、時間、URI、レイテンシを含むツールチップが表示されます。

レイテンシ情報を表示するトレース ツールチップの図。

ドットをクリックすると、次の変更が行われます。

  • グラフが更新され、選択したドットが円で囲まれてハイライト表示されます。
  • リクエストのテーブルで、選択した URI がハイライト表示されます。
  • [トレースリスト] ページで 2 つの新しいペインが開く場合があります。ウォーターフォール グラフには URI の各スパンが表示されます。詳細ペインには URI の詳しい情報が表示され、ログと分析レポートのリンクが表示されます(利用可能な場合)。 これらのペインがすでに開いている場合は、ドットをクリックすると、このペインに表示されるデータが更新されます。

最近のリクエストのテーブル

デフォルトでは、最近のリクエスト テーブルには最新の 5 つのリクエストが表示されます。テーブルには 1,000 個のトレースが保存されます。

属性 説明
レイテンシ アプリケーションがリクエストを処理するためのエンドツーエンドでの時間。
HTTP メソッド HTTP メソッドのタイプ(該当する場合)。HTTP 以外のリクエストの場合、このフィールドは空欄です。
URI リクエストの相対 URI。
分析レポート 関連分析レポートへのリンク(使用可能な場合)。
時間 リクエストが開始された時間。

次のいずれかの方法で、テーブルに表示されるリクエストを変更できます。

  • 期間を選択します。
  • [前へ] ボタンと [次へ] ボタンを使用して、前後に移動します。
  • 列ヘッダーをクリックすると、行の順序を変更できます。
  • レイテンシ グラフでドットをクリックします。

次のステップ