翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
このドキュメントのトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 9 での作業」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 8 での作業」を参照してください。
Explore を使用して、トレース中のデータソースからトレースを視覚化できます。
以下のデータソースがサポートされています。
上記のデータソースのクエリを設定する方法については、特定のデータソースのドキュメントを参照してください。
クエリエディタ
データソースのクエリエディタを使用して、トレース中のデータをクエリおよび検索できます。
各データソースには、独自のクエリエディタを使用できます。Tempo データソースのクエリエディタは、Jaeger データソースのクエリエディタとは若干異なります。
各データソースのクエリについては、各ドキュメントを参照してください。
トレースビューの説明
このセクションでは、Trace View ダッシュボードの要素について説明します。
ヘッダー
トレースビューのヘッダーには、次の要素があります。
-
ヘッダータイトル – ルートスパンの名前とトレース ID を表示します。
-
検索 – 検索されたテキストを含むスパンを強調表示します。
-
メタデータ – トレースに関するさまざまなメタデータを表示します。
ミニマップ
要約ビューまたはトレースタイムラインを表示します。ポインタをミニマップにドラッグして、より短い時間範囲にズームインできます。ズームはメインタイムラインも更新するため、短いスパンを簡単に確認できます。ミニマップにカーソルを合わせ、ズームすると、ズームをリセットする [選択のリセット] ボタンが表示されます。
スパンフィルター
スパンフィルターを使用すると、トレースタイムラインビューワーでスパンをフィルタリングできます。追加するフィルターが多いほど、フィルターされたスパンがより具体的になります。
次の 1 つ以上のフィルターを追加できます。
-
リソースサービス名
-
スパン名
-
期間
-
タグ (タグ、プロセスタグ、ログフィールドを含む)
一致したスパンのみを表示するには、[Show matches only] (一致のみを表示) トグルを選択します。
タイムライン
トレース内のスパンのリストを表示します。各スパン行は、次の要素で構成されます。
-
[Expand children] (子を展開) ボタン – 選択したスパンのすべての子スパンを展開または折りたたみます。
-
サービス名 – スパンをログに記録したサービスの名前。
-
オペレーション名 – このスパンが表すオペレーションの名前。
-
スパン期間バー – トレース内のオペレーション期間の視覚的表現。
スパンの詳細
スパン行を選択すると、以下を含むスパンの詳細が表示されます。
オペレーション名
スパンメタデータ
タグ – このスパンに関連付けられている任意のタグ。
プロセスメタデータ – このスパンをログに記録したプロセスに関するメタデータ。
ログ – このスパンおよび関連するキー値によってログに記録されたログのリスト。Zipkin ログの場合、セクションには Zipkin 注釈が表示されます。
ログへのトレース
トレースビューのスパンから、そのスパンに関連するログに直接移動できます。これは、Tempo、Jaeger、および Zipkin データソースで使用できます。各データソースの設定方法については、関連するドキュメントを参照してください。
ドキュメントアイコンを選択して、設定されたデータソースを使用して Explore で分割ビューを開き、スパンに関連するログに対してクエリを実行します。
メトリクスへのトレース
注記
現在、この機能はベータモードです。
トレースビューのスパンから、そのスパンに関連するメトリクスに直接移動できます。この機能は、Tempo、Jaeger、および Zipkin データソースで使用できます。設定の詳細については、関連するドキュメントを参照してください。
プロファイルへのトレース
[Trace to profiles] (プロファイルへのトレース) を使用すると、トレースとプロファイルをリンクする機能を追加することで、さまざまなシグナルを関連付けられる Grafana の機能を利用できます。
ノードグラフ
オプションで、表示されたトレースのノードグラフを展開できます。データソースによっては、トレースのスパンをグラフ内のノードとして表示したり、現在のトレースに基づくサービスグラフなどのコンテキストを追加したりできます。
サービスグラフビュー
Service Graph ビューは、スパンメトリクス (レート、エラーレート、期間 (RED) のデータを追跡) とサービスグラフを視覚化します。要件が設定されると、この事前設定されたビューがすぐに利用できます。
詳細については、Tempo データソースのページを参照してください。サービスグラフビューページ
Data API
この視覚化では、正しく表示するために、データソースから返されるデータの特定の形状が必要です。
データソースはデータフレームを返し、frame.meta.preferredVisualisationType = 'trace' を設定する必要があります。
データフレーム構造
必須フィールド
| フィールド名 | タイプ | 説明 |
|---|---|---|
| traceID | 文字列 | トレース全体の識別子。データフレームには 1 つのトレースのみが必要です。 |
| spanID | 文字列 | 現在のスパンの識別子。SpanID はトレースごとに一意である必要があります。 |
| parentSpanID | 文字列 | トレースビューで子親関係を作成するための親スパンの SpanID。親のないルートスパンでは undefined になる場合があります。 |
| serviceName | 文字列 | このスパンが属するサービスの名前。 |
| serviceTags | TraceKeyValuePair[] | サービスに関連するタグのリスト。 |
| startTime | 数値 | スパンの開始時刻をミリ秒エポック時間で表します。 |
| duration | 数値 | スパンの期間 (ミリ秒)。 |
オプションのフィールド
| フィールド名 | タイプ | 説明 |
|---|---|---|
| ログ | TraceLog[] | 現在のスパンに関連付けられたログのリスト。 |
| タグ | TraceKeyValuePair[] | 現在のスパンに関連付けられたタグのリスト。 |
| warnings | string[] | 現在のスパンに関連付けられた警告のリスト。 |
| stackTraces | string[] | 現在のスパンに関連付けられたスタックトレースのリスト。 |
| errorIconColor | 文字列 | スパンに error:
true がタグ付けされている場合のエラーアイコンの色。 |
タイプの詳細については、GitHub の TraceSpanRow
