翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# トレース
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 12.x をサポートする Grafana ワークスペースについては、「」を参照してください[Grafana バージョン 12 での作業](using-grafana-v12.md)。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
トレースの視覚化により、インフラストラクチャ内のサービスを横断するリクエストに従うことができます。トレースの視覚化は、トレースデータを簡単に解釈できる図でトレースデータを表示します。
トレースとその使用方法の詳細については、次のドキュメントを参照してください。
+ [Explore でのトレース](v10-explore-tracing.md)
+ [Tempo データソース](tempo-data-source.md)
+ *Grafana Labs Tempo ドキュメント*の「[Tempo での使用開始](https://grafana.com/docs/tempo/latest/getting-started/)」。
## トレースの視覚化を含むパネルの追加
Grafana スタックでトレースデータが利用可能になると、Grafana ダッシュボードにトレースパネルを追加できます。
ダッシュボード変数 `traceID` を使用すると、特定のトレース ID に対する特定のトレースを表示するクエリを作成できます。ダッシュボード変数の詳細については、「[ 変数ドキュメント](v10-dash-variables.md)」を参照してください。
**前提条件**
開始するには、以下が必要です。
+ Amazon Managed Grafana ワークスペース。
+ ワークスペースに接続された [Tempo データソース](tempo-data-source.md)。
ダッシュボード内のトレースデータを表示および分析するには、ダッシュボードにトレースの視覚化を追加し、パネルエディタを使用してクエリを定義する必要があります。クエリは、視覚化に表示されるデータを決定します。パネルエディタの詳細については、「[パネルエディタのドキュメント](v10-panels-editor-overview.md)」を参照してください。
この手順では、ダッシュボード変数とテンプレートを使用して、視覚化できるトレース ID を入力できます。`traceId` という変数を使用して、テンプレートクエリとして追加します。
**トレース視覚化クエリを追加するには**
1. ワークスペースで、新しいダッシュボードを作成するか、トレースの視覚化を追加する既存のダッシュボードに移動します。
1. 新しいダッシュボードから **[視覚化を追加]** を選択するか、既存のダッシュボードで**[パネルの追加]** を選択します。
1. 適切なトレースデータソースを選択します。
1. パネルエディタの右上で **[視覚化]** タブを選択し、**トレース**を選択します。
1. **パネルオプション**で、トレースパネルの**タイトル**を入力します。パネルエディタの詳細については、「[パネルオプションの設定](v10-panels-configure-panel-options.md)」を参照してください。
1. クエリエディタで、**TraceQL** クエリタイプタブを選択します。
1. TraceQLクエリフィールドに `${traceId}` を入力して、ダッシュボード変数を作成します。この変数はテンプレートクエリとして使用されます。
1. パネルエディタで **[適用]** を選択して、ダッシュボードにパネルを追加します。
1. 必要に応じて、ダッシュボードの**設定**に移動し、`traceId` という名前の新しい変数を変数タイプ**カスタム**で追加し、ラベルを付与します。**[適用]** を選択して、ダッシュボードに変数を追加します。
1. トレースパネルに使用されるデータソースに有効なトレース ID を使用し、ダッシュボード変数で ID を編集して、パネルが機能することを確認します。
## テーブルの視覚化による TraceQL の追加
ダッシュボードにトレースの視覚化を追加することはできますが、ダッシュボード変数としてトレース ID を手動で追加しなければならないのは面倒です。代わりに、TraceQL クエリを使用して特定のタイプのトレースを検索し、一致する結果から適切なトレースを選択できる方が便利です。
**前提条件**
この手順は、前の手順を完了したことを前提としています。
**テーブル視覚化で TraceQL を追加するには**
1. トレース視覚化を追加したのと同じダッシュボードで、**[パネルの追加]** を選択して新しい視覚化パネルを追加します。
1. 前のセクションで使用したのと同じトレースデータソースを選択します。
1. パネルエディタの右上で **[視覚化]** タブを選択し、**テーブル**を選択します。
1. クエリエディタで、**[TraceQL]** タブを選択します。
1. **パネルオプション**で、トレースパネルの**タイトル**を入力します。
1. ダッシュボードで視覚化するトレースを検索するには、適切な TraceQL クエリを追加します。例えば、{{my-server}} は、サーバーからのシンプルで静的なクエリです。
```
{ .service.name = "{{my-server}}" && .http.status_code=500 }
```
TraceQL クエリは、他のダッシュボード変数が存在する場合、それらを利用するテンプレートクエリとして記述できます。これにより、これらの変数に基づいて動的クエリを作成できます。
クエリから結果が返されると、結果はパネルのテーブルにレンダリングされます。
トレース視覚化の結果には、トレースをレンダリングする **Explore** ページへのリンクが含まれます。選択時に `traceId` ダッシュボード変数を埋めるテーブル内のトレースに他のリンクを追加して、トレースが同じダッシュボードで視覚化されるようにできます。
パネルに一連のデータリンクを作成するには、次の手順を使用します。
**変数を使用してトレースに他のリンクを追加するには**
1. 右側のメニューにある **[データリンク]** で、**[リンクの追加]** を選択します。
1. データリンクの**タイトル**を追加します。
1. 完全なダッシュボードがレンダリングされているときにブラウザのアドレスバーを見て、ダッシュボードへのパスを見つけます。これは同じ Grafana スタック内のダッシュボードへのリンクであるため、ダッシュボードのパスのみが必要です。
例えば、パスが以下の場合:
```
https://g-example.grafana-workspace.us-east-1.amazonaws.com{{/d/1234abcd5/my-dashboard?orgId=1}}
```
ダッシュボードへのパスは次のとおりです。
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. **URL** フィールドで、両方のパネルを含むダッシュボードを自己参照します。この自己参照では、テーブル内の選択したトレースの値を使用してダッシュボード変数を入力します。前のステップで見つけたダッシュボードのパスを使用して、TraceQL テーブルから選択した結果を使用する `traceId` の値を入力します。トレース ID は、返された結果の `traceID` データフィールドを使用して公開されるため、ダッシュボード変数の値として使用します。例:
```
/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
```
1. **[保存]** を選択すると、データリンクを保存できます。
1. パネルエディタから **[適用]** を選択すると、ダッシュボードにパネルを適用できます。
1. ダッシュボードを保存します。
これで、テーブルの視覚化に一致するトレースのリストが表示されます。**TraceID** フィールドまたは **SpanID** フィールドを選択すると、トレースを視覚化する **Explore** ページを開くか、データリンクをたどるオプションが表示されます。他のフィールド (`Start time`、`Name`、 `Duration`など) を選択すると、自動的にデータリンクが続き、`traceId` ダッシュボード変数に入力されることで、トレースパネルに関連するトレースが表示されます。