Explore でのトレース

このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。

Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。

Explore を使用して、データソースのトレースを視覚化できます。

以下のデータソースがサポートされています。

• Tempo (サポートされている取り込み形式: OpenTelemetry、Jaeger、Zipkin)

• Jaeger

• AWS X-Ray

• Zipkin

上記のデータソースのクエリを設定する方法については、特定のデータソースのドキュメントを参照してください。

クエリエディタ

データソースのクエリエディタを使用して、トレースデータをクエリおよび検索できます。

各データソースには独自のクエリエディタを設定できます。Tempo データソースのクエリエディタは、Jaeger データソースのクエリエディタと若干異なります。

各データソースのクエリについては、そのドキュメントを参照してください。

• テンポ

• Jaeger

• AWS X-Ray

• Zipkin

トレースビューの説明

このセクションでは、トレースビューダッシュボードの要素について説明します。

ヘッダー

トレースビューの ヘッダーには、次の要素があります。

• ヘッダータイトル — ルートスパンの名前とトレース ID を表示します。

• 検索 — 検索されたテキストを含むスパンをハイライトします。

• メタデータ — トレースに関するさまざまなメタデータ。

ミニマップ

要約ビューまたはトレースタイムラインを表示します。ポインタをミニマップにドラッグして、より小さな時間範囲にズームインします。ズームするとメインタイムラインも更新されるため、短いスパンを簡単に確認できます。ミニマップにカーソルを合わせると、ズーム時にズームをリセットする選択のリセットボタンが表示されます。

スパンフィルター

スパンフィルターを使用すると、トレースタイムラインビューワーでスパンをフィルタリングできます。追加するフィルターが多いほど、フィルタリングされたスパンがより具体的になります。

次のフィルターを 1 つ以上追加できます。

• リソースサービス名

• スパン名

• duration

• タグ (タグ、プロセスタグ、ログフィールドを含む）

一致したスパンのみを表示するには、「一致のみを表示」トグルを選択します。

タイムライン

トレース内のスパンのリストを表示します。各スパン行は、次のコンポーネントで構成されます。

• 子を展開ボタン – 選択したスパンのすべての子スパンを展開または折りたたみます。

• サービス名 – スパンを記録したサービスの名前。

• オペレーション名 – このスパンが表すオペレーションの名前。

• スパン継続時間バー – トレース内のオペレーション継続時間の視覚的表現。

スパンの詳細

スパン行を選択すると、次のようなスパンの詳細が表示されます。

• オペレーション名

• スパンメタデータ

• タグ — このスパンに関連付けられているすべてのタグ。

• プロセスメタデータ — このスパンを記録したプロセスに関するメタデータ。

• ログ – このスパンによってログに記録されたログのリストと、関連するキー値。Zipkin Logs の場合、 セクションには Zipkin 注釈が表示されます。

ログへのトレース

トレースビューのスパンから、そのスパンに関連するログに直接移動できます。これは、Tempo、Jaeger、および Zipkin データソースで使用できます。各データソースの設定方法については、関連するドキュメントを参照してください。

ドキュメントアイコンを選択して、設定されたデータソースを使用して Explore で分割ビューを開き、スパンに関連するログをクエリします。

メトリクスへのトレース

注記

この機能は現在ベータ版です

トレースビューのスパンから、そのスパンに関連するメトリクスに直接移動できます。この機能は、Tempo、Jaeger、および Zipkin データソースで使用できます。設定の詳細については、関連するドキュメントを参照してください。

プロファイルへのトレース

トレースをプロファイルに使用すると、トレースとプロファイルをリンクする機能を追加することで、Grafana のさまざまなシグナルを関連付けることができます。

ノードグラフ

オプションで、表示されたトレースのノードグラフを展開できます。データソースによっては、トレースのスパンをグラフ内のノードとして表示したり、現在のトレースに基づくサービスグラフを含むコンテキストを追加したりできます。

サービスグラフビュー

サービスグラフビューは、スパンメトリクス (レート、エラー率、期間 (RED) のデータを追跡) とサービスグラフを視覚化します。要件を設定すると、この事前設定済みビューがすぐに利用可能になります。

詳細については、「一時データソースページ」を参照してください。Grafana Labs Tempo ドキュメント のサービスグラフビューページも参照できます。

Data API

この視覚化では、データを正しく表示するために、データソースから返されるデータの特定の形状が必要です。

データソースはデータフレームを返し、 を設定する必要がありますframe.meta.preferredVisualisationType = 'trace'。

データフレーム構造

必須フィールド

フィールド名	タイプ	説明
traceID	string	トレース全体の識別子。データフレームにはトレースが 1 つだけ必要です。
spanID	string	現在のスパンの識別子。SpanIDsはトレースごとに一意である必要があります。
parentSpanID	string	トレースビューで子親関係を作成するための親スパンの SpanID。親のないルートスパンundefinedにすることができます。
serviceName	string	このスパンが属するサービスの名前。
serviceTags	TraceKeyValuePair[]	サービスに関連するタグのリスト。
startTime	数値	ミリ秒エポック時間単位のスパンの開始時刻。
duration	数値	ミリ秒単位のスパンの期間。

オプションフィールド：

フィールド名	タイプ	説明
ログ	TraceLog[]	現在のスパンに関連付けられているログのリスト。
タグ	TraceKeyValuePair[]	現在のスパンに関連付けられているタグのリスト。
warnings	string[]	現在のスパンに関連する警告のリスト。
stackTraces	string[]	現在のスパンに関連付けられているスタックトレースのリスト。
errorIconColor	string	スパンが でタグ付けされている場合のエラーアイコンの色error: true。

タイプの詳細については、「」のTraceSpanRowTraceKeyValuePair「」およびTraceLog「」を参照してください GitHub。