カスタム ダッシュボードにトレースを表示する

このドキュメントでは、カスタム ダッシュボードにトレースデータを表示する方法について説明します。トレース ウィジェットをダッシュボードに追加すると、スパン レイテンシとシステム指標およびアプリケーション ログを関連付ける統合トラブルシューティング ビューを構築できます。

トレースデータをダッシュボードに表示するには、トレース固有のウィジェットを追加するか、[Trace エクスプローラ] ページの保存オプションを使用するか、Cloud Monitoring API を使用します。

トレースデータの可視化

[トレース エクスプローラ] ページには、トラブルシューティング用に事前構成された一連の可視化機能が用意されています。デフォルトでは、スパン レイテンシのヒートマップと、個々のスパンまたはグループ化されたスパンのリストが表示されます。詳細については、トレースを検索して調査するをご覧ください。

カスタム ダッシュボードはモジュール式であるため、個々のトレース ウィジェットを組み合わせて、この包括的なビューの永続バージョンを構築できます。たとえば、グループ化されたスパンと個々のスパンの別々のテーブルの横にヒートマップ ウィジェットを追加できます。このレイアウトをダッシュボードで再作成すると、他のテレメトリーとともに、トレースデータのすべての側面を単一の共有ビューでモニタリングできます。

トレースデータを示すダッシュボード。

デフォルトでは、トレース ウィジェットにはデフォルトのトレース スコープのリソースのデータが表示されます。ただし、個々のウィジェットのスコープを変更して、別のプロジェクトを検索したり、特定のリソース グループに焦点を当てたりできます。

トレース ウィジェットを編集すると、トレース エクスプローラの統合バージョンが開きます。このエディタでは、調査を行う場合と同様に、フィルタを追加したり、構成オプションを変更したりしてから、永続的な変更をダッシュボード タイルに適用できます。

始める前に

カスタム ダッシュボードにトレースデータを表示するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ダッシュボードには最大で 100 個のウィジェットを配置できます。

[Trace エクスプローラ] ページの保存オプションを使用する

トレース エクスプローラには、トレースデータの複数の可視化が用意されています。これらの可視化をダッシュボードに追加して、同様のビューを作成できます。

[トレース エクスプローラ] のデータをカスタム ダッシュボードに保存する手順は次のとおりです。

  1. Google Cloud コンソールで、 [Trace エクスプローラ] ページに移動します。

    [Trace エクスプローラ] に移動

    このページは、検索バーを使用して見つけることもできます。

  2. ツールバーで [ダッシュボードに保存] を選択します。

  3. 表示スタイルを選択します。以下のいずれかをご検討ください。

    • Visualizer: ダッシュボードにヒートマップを追加します。
    • スパンテーブル: 個々のスパンのテーブルをダッシュボードに追加します。
    • グループ化されたスパンテーブル: グループ化されたスパンのテーブルをダッシュボードに追加します。

  4. ダッシュボードを選択または作成します。

  5. [Save to dashboard] をクリックします。

カスタム ダッシュボードにトレース ウィジェットを追加する

このセクションでは、カスタム ダッシュボードにトレースデータを表示する方法について説明します。これらの手順は Google Cloud コンソール用であり、ダッシュボードを編集していることを前提としています。Cloud Monitoring API の使用方法については、トレースデータを表示するダッシュボードをご覧ください。

カスタム ダッシュボードにトレースデータを表示する手順は次のとおりです。

  1. カスタム ダッシュボードを開くには:

    1. Google Cloud コンソールで [ダッシュボード] ページに移動します。

      [ダッシュボード] に移動

      検索バーを使用してこのページを検索する場合は、小見出しが「Monitoring」の結果を選択します。

    2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。

    3. ダッシュボードを選択するか、[ダッシュボードを作成] をクリックします。

      ダッシュボードを作成する場合は、[スコープ] メニューを使用して、トレースデータの検索対象となるリソースを構成します。デフォルトでは、システムはデフォルトのトレース スコープのリソースでトレースデータを検索します。

  2. ツールバーで [ ウィジェットを追加] をクリックします。

  3. [ウィジェットを追加] ダイアログで、[データ] セクションに移動して [トレース] を選択します。

  4. Trace ウィジェットを構成します。デフォルトのビューを変更したり、タイトルを変更したり、フィルタを追加したりできます。

    • ビューを変更するには、ツールバーで [グラフビュー] メニューを開き、ビューを選択します。

      • ヒートマップ（デフォルト）を追加するには、[スパン期間（ヒートマップ）] を選択します。
      • スパンのレートを表示するには、[スパンレート（折れ線グラフ）] を選択します。
      • レイテンシ データを表示するには、[スパン期間（パーセンタイル）] を選択します。
      • スパンをテーブル形式で一覧表示するには、[スパンレート（折れ線グラフ）] または [スパン期間（パーセンタイル）] を選択し、[ウィジェット タイプ] メニューを使用してテーブルを表示します。セレクタを使用すると、グループ化されたデータまたはグループ化されていないデータを表示できます。

    • 表示されるトレースを制限するには、フィルタを追加します。

    • タイトルを更新するには、[ウィジェットのタイトル] フィールドに新しいタイトルを入力します。

  5. 変更をダッシュボードに適用するには、ツールバーで [適用] をクリックします。変更を破棄するには、[キャンセル] をクリックします。

  6. 変更したダッシュボードを保存するには、ツールバーで [保存] をクリックします。

トレース データを表示するウィジェットを変更または編集する

ウィジェットを変更するには、ウィジェットの上にポインタを置いてツールバーを有効にし、 [ウィジェットを編集] をクリックします。

Trace Explorer エディタが開きます。このビューで、フィルタを追加または削除したり、構成オプションを変更したりできます。変更をダッシュボードに適用するか、破棄するかを選択できます。

制限事項

  • ダッシュボード レベルのフィルタは、トレース ウィジェットには適用されません。
  • トレース ウィジェットのクエリに変数を適用することはできません。

次のステップ