トレース - Amazon Managed Grafana

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

トレース

このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。

Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業

トレースの視覚化により、インフラストラクチャ内のサービスを通過するリクエストに従うことができます。トレースの視覚化では、トレースデータを図に表示し、簡単に解釈できます。

トレースとその使用方法の詳細については、次のドキュメントを参照してください。

トレースビジュアライゼーションを含むパネルの追加

Grafana スタックでトレースデータが利用可能になったら、Grafana ダッシュボードにトレースパネルを追加できます。

ダッシュボード変数 を使用するとtraceID、特定のトレース ID の特定のトレースを表示するクエリを作成できます。ダッシュボード変数の詳細については、「Variables ドキュメント」を参照してください。

前提条件

開始するには、以下が必要です。

ダッシュボードでトレースデータを表示および分析するには、ダッシュボードにトレースの視覚化を追加し、パネルエディタを使用してクエリを定義する必要があります。クエリは、視覚化に表示されるデータを決定します。パネルエディタの詳細については、「パネルエディタのドキュメント」を参照してください。

この手順では、ダッシュボード変数とテンプレートを使用してトレース IDsを入力できます。トレース ID は視覚化できます。という変数を使用してテンプレートクエリとしてtraceId追加します。

トレースの視覚化クエリを追加するには
  1. ワークスペースで、新しいダッシュボードを作成するか、トレースの視覚化を追加する既存のダッシュボードに移動します。

  2. 新しいダッシュボードから視覚化を追加 を選択するか、既存のダッシュボードでパネルを追加 を選択します。

  3. 適切なトレースデータソースを選択します。

  4. パネルエディタの右上で、視覚化タブを選択し、トレース を選択します。

  5. パネルオプション で、トレースパネルのタイトルを入力します。パネルエディタの詳細については、「」を参照してくださいパネルオプションの設定

  6. クエリエディタで、TraceQL クエリタイプタブを選択します。

  7. TraceQL ${traceId} クエリフィールドに を入力して、ダッシュボード変数を作成します。この変数はテンプレートクエリとして使用されます。

  8. パネルエディタで適用 を選択して、ダッシュボードにパネルを追加します。

  9. ダッシュボードの設定に移動しtraceId、必要に応じて という新しい変数を 変数タイプカスタム に追加し、ラベルを付けます。Apply を選択して、変数をダッシュボードに追加します。

  10. トレースパネルに使用されるデータソースに有効なトレース ID を使用し、ダッシュボード変数で ID を編集して、パネルが機能することを確認します。

テーブルビジュアライゼーションでの TraceQL の追加

トレースの視覚化をダッシュボードに追加することはできますが、トレース IDs をダッシュボード変数として手動で追加する必要は煩雑です。代わりに、TraceQL クエリを使用して特定のタイプのトレースを検索し、一致する結果から適切なトレースを選択できる方が便利です。

前提条件

この手順は、前の手順を完了していることを前提としています。

テーブルの視覚化で TraceQL を追加するには
  1. トレースの視覚化を追加したのと同じダッシュボードで、パネルを追加 を選択して新しい視覚化パネルを追加します。

  2. 前のセクションで使用したのと同じトレースデータソースを選択します。

  3. パネルエディタの右上で、視覚化タブを選択し、テーブル を選択します。

  4. クエリエディタで、TraceQL タブを選択します。

  5. パネルオプション の下に、トレースパネルのタイトルを入力します。

  6. 適切な TraceQL クエリを追加して、ダッシュボードで視覚化するトレースを検索します。例えば、my-server というサーバーからのシンプルな静的クエリを次に示します。

    { .service.name = "my-server" && .http.status_code=500 }

    TraceQL クエリをテンプレートクエリとして記述して、他のダッシュボード変数が存在する場合、それらを活用できます。これにより、これらの変数に基づいて動的クエリを作成できます。

クエリから結果が返されると、結果はパネルのテーブルにレンダリングされます。

トレースの視覚化の結果には、トレースをレンダリングする探索ページへのリンクが含まれます。選択時にtraceIdダッシュボード変数を埋めるテーブル内のトレースに他のリンクを追加して、トレースを同じダッシュボードで視覚化できます。

パネルで一連のデータリンクを作成するには、次の手順を使用します。

変数を使用してトレースに他のリンクを追加するには
  1. 右側のメニューのデータリンク で、リンクを追加 を選択します。

  2. データリンクのタイトルを追加します。

  3. ダッシュボード全体を表示しているときにブラウザのアドレスバーを見て、ダッシュボードへのパスを見つけます。これは同じ Grafana スタック内のダッシュボードへのリンクであるため、ダッシュボードのパスのみが必要です。

    例えば、パスが の場合:

    https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1

    次に、ダッシュボードへのパスは次のとおりです。

    /d/1234abcd5/my-dashboard?orgId=1
  4. URL フィールドで、両方のパネルを含むダッシュボードを自己参照します。この自己参照では、テーブル内の選択したトレースの値を使用してダッシュボード変数を入力します。前のステップのダッシュボードのパスを使用して、TraceQL テーブルから選択した結果traceIdを使用する の値を入力します。トレース ID は、返された結果traceIDのデータフィールドを使用して公開されるため、ダッシュボード変数の値として使用します。例:

    /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
  5. データリンクを保存するには、保存を選択します。

  6. パネルエディタから適用 を選択して、ダッシュボードにパネルを適用します。

  7. ダッシュボードを保存します。

これで、テーブルの視覚化に一致するトレースのリストが表示されます。TraceID または SpanID フィールドを選択すると、トレースを視覚化する探索ページを開くか、データリンクをたどるかを選択できます。他のフィールド (Start timeName、 などDuration) を選択すると、自動的にデータリンクが続き、traceIdダッシュボード変数に入力され、トレースパネルに関連するトレースが表示されます。