トレースを検索して調査する

トレースデータの集計表現を表示したり、特定のラベルを含む個々のトレースやトレースを検索して調査したりするには、[Trace エクスプローラ] ページを使用します。

次のスクリーンショットは、トレース データがどのように表示されるかを示しています。

トレースデータの表示例。

スパンの集計分析を行うクエリを実行するには、[オブザーバビリティ分析] ページまたは BigQuery を使用します。どちらのインターフェースも、SQL を使用してスパンデータをクエリできます。[オブザーバビリティ分析] ページを使用すると、クエリ結果を表またはグラフとして表示できます。SQL を使用してトレースデータをクエリする方法については、トレースをクエリして分析するをご覧ください。

この機能は Google Cloud プロジェクトでのみサポートされています。App Hub の構成には、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。

[Trace エクスプローラ] ページについて

トレースデータの傾向とパターンを特定できるように、レイテンシ データが集計され、グラフに表示されます。ヒートマップでは、セルのスパンの数が色で表されます。スパンの多いセルは、スパンの少ないセルよりも色が濃くなります。各セルのツールチップには、レイテンシなどの情報が表示されます。レイテンシのパーセンタイルとスパン率の情報を表示することもできます。

問題を調査する際に、特定のトレースや特定のプロパティを持つスパンのみを表示することがあります。

  • 表示されるスパンを制限するには、フィルタを適用します。たとえば、サービス、アプリケーション、エラー状態などのプロパティでフィルタできます。

  • 特定のトレースを表示するには、ツールバーの [] [トレースを検索] オプションを使用します。

外れ値を特定し、個々のスパンの詳細を表示するには、表形式のセクションを使用します。

  • [スパン] タブと [グループ化] タブの行は、期間ヘッダーで並べ替えることができます。

  • さまざまなサービスで生成されているスパンの数を確認するには、[グループ化] タブを使用します。各行はサービスとスパン名に対応し、各エントリのレイテンシ統計情報が表示されます。

スパンまたはグループ化の詳細を確認するには、表形式のセクションの行からエントリを選択します。フライアウトが開き、トレースのコンテキストでスパンが表示されます。このビューでは、スパンとその属性を調べたり、イベントとログデータを表示したりできます。トレース内のスパンや属性をキーワードで検索することもできます。

[Trace エクスプローラ] ページに表示されるトレースデータは、次の要素によって異なります。

  • スコープ設定。システムがトレースデータを検索するビューを決定します。ページが開くと、[スコープ] 要素がデフォルトのトレース スコープに設定され、システムはそのスコープにリストされているビューに対してトレースデータをクエリします。

    新しいプロジェクトでは、デフォルトのトレース スコープにプロジェクトの _AllSpans ビューが一覧表示されます。このビューは、プロジェクトが保存するすべてのトレースデータへの読み取りアクセス権を付与します。

  • 検索対象ビューに対する Identity and Access Management（IAM）権限。プロジェクトのトレース データを表示する権限がない場合、 Google Cloud コンソールに警告メッセージが表示され、そのプロジェクトのデータは表示されません。

  • 期間の設定。

  • 適用するフィルタ。

トレースデータはカスタム ダッシュボードに保存できます。詳細については、カスタム ダッシュボードにトレースデータを表示するをご覧ください。

このページの残りの部分では、トレースデータを検索して調査する方法について詳しく説明します。

始める前に

Google Cloud コンソールを使用してトレースデータを表示し、トレース スコープを選択するために必要な権限を取得するには、プロジェクトに対する Cloud Trace ユーザー （roles/cloudtrace.user）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、 Google Cloud コンソールを使用してトレースデータを表示し、トレース スコープを選択するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

Google Cloud コンソールを使用してトレースデータを表示し、トレース スコープを選択するには、次の権限が必要です。

  • トレース スコープを選択する: cloudtrace.traceScopes.[get, list]
  • デフォルトのトレース スコープを読み取る: observability.scopes.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

ロールの詳細については、Identity and Access Management を使用してアクセスを制御するをご覧ください。

集計されたトレースデータを表示する

トレースデータの集計情報を表示するには、次の操作を行います。