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