翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Explore でのトレース
<a name="v10-explore-tracing"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

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

以下のデータソースがサポートされています。
+ [Tempo](tempo-data-source.md) (サポートされている取り込み形式: OpenTelemetry 、Jaeger、Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

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

## クエリエディタ
<a name="v10-explore-trace-queryeditor"></a>

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

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

各データソースのクエリについては、各ドキュメントを参照してください。
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## トレースビューの説明
<a name="v10-explore-trace-view"></a>

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

**ヘッダー**

トレースビューのヘッダーには、次の要素があります。
+ ヘッダータイトル – ルートスパンの名前とトレース ID を表示します。
+ 検索 – 検索されたテキストを含むスパンを強調表示します。
+ メタデータ – トレースに関するさまざまなメタデータを表示します。

**ミニマップ**

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

**スパンフィルター**

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

次の 1 つ以上のフィルターを追加できます。
+ リソースサービス名
+ スパン名
+ 時間
+ タグ (タグ、プロセスタグ、ログフィールドを含む)

一致したスパンのみを表示するには、**[Show matches only]** (一致のみを表示) トグルを選択します。

**タイムライン**

トレース内のスパンのリストを表示します。各スパン行は、次の要素で構成されます。
+ [Expand children] (子を展開) ボタン – 選択したスパンのすべての子スパンを展開または折りたたみます。
+ サービス名 – スパンをログに記録したサービスの名前。
+ オペレーション名 – このスパンが表すオペレーションの名前。
+ スパン期間バー – トレース内のオペレーション期間の視覚的表現。

**スパンの詳細**

スパン行を選択すると、以下を含むスパンの詳細が表示されます。
+ オペレーション名
+ スパンメタデータ
+ タグ – このスパンに関連付けられている任意のタグ。
+ プロセスメタデータ – このスパンをログに記録したプロセスに関するメタデータ。
+ ログ – このスパンおよび関連するキー値によってログに記録されたログのリスト。Zipkin ログの場合、セクションには Zipkin 注釈が表示されます。

**ログへのトレース**

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

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

**メトリクスへのトレース**

**注記**  
現在、この機能はベータモードです。

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

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

[Trace to profiles] (プロファイルへのトレース) を使用すると、トレースとプロファイルをリンクする機能を追加することで、さまざまなシグナルを関連付けられる Grafana の機能を利用できます。

## ノードグラフ
<a name="v10-explore-trace-node-graph"></a>

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

## サービスグラフビュー
<a name="v10-explore-trace-graph"></a>

Service Graph ビューは、スパンメトリクス (レート、エラーレート、期間 (RED) のデータを追跡) とサービスグラフを視覚化します。要件が設定されると、この事前設定されたビューがすぐに利用できます。

詳細については、[Tempo](tempo-data-source.md) データソースのページを参照してください。[サービスグラフビューページ](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)は、「*Grafana Labs Tempo ドキュメント*」でも確認できます。

## Data API
<a name="v10-explore-trace-dataapi"></a>

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

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

**データフレーム構造**

必須フィールド


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

 オプションのフィールド 


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

タイプの詳細については、GitHub の [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)、[TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)、および [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12) を参照してください。