翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Explore でのトレース
このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。
Explore を使用して、データソースのトレースを視覚化できます。
以下のデータソースがサポートされています。
上記のデータソースのクエリを設定する方法については、特定のデータソースのドキュメントを参照してください。
クエリエディタ
データソースのクエリエディタを使用して、トレースデータをクエリおよび検索できます。
各データソースには独自のクエリエディタを設定できます。Tempo データソースのクエリエディタは、Jaeger データソースのクエリエディタと若干異なります。
各データソースのクエリについては、そのドキュメントを参照してください。
トレースビューの説明
このセクションでは、トレースビューダッシュボードの要素について説明します。
ヘッダー
トレースビューの ヘッダーには、次の要素があります。
-
ヘッダータイトル — ルートスパンの名前とトレース 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 。 |
タイプの詳細については、「」のTraceSpanRow