Explore の Inspector

このドキュメントのトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けです。

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

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

インスペクターは、クエリの理解とトラブルシューティングに役立ちます。未加工データを検査し、そのデータをカンマ区切り値 (CSV) ファイルにエクスポートし、ログ結果を TXT 形式でエクスポートし、クエリリクエストを表示できます。

Inspector UI

インスペクターには次のタブがあります。

• [統計タブ] – クエリにかかる時間および返される量を示します。

• [クエリタブ] – Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。

• [JSON] タブ – データ JSON とデータフレーム構造 JSON を表示およびコピーできます。

• [データタブ] – クエリによって返される未加工データを表示します。

• [エラータブ] – エラーを表示します。クエリがエラーを返す場合にのみ表示されます。

Inspector タスク

Explore Inspector では、さまざまなタスクを実行できます。

Inspector を開く

検査するクエリを実行したら、[Inspector] ボタンを選択します。

画面の下部にインスペクターペインが開きます。

未加工クエリ結果の検査

未加工のクエリ結果、つまりクエリによって返されるデータをテーブルに表示できます。

[Inspector] タブで、[Data] タブをクリックします。

複数のクエリまたは複数のノードのクエリには、追加のオプションがあります。

• [データフレームを表示する]: 表示する結果セットデータを選択します。

• [時間で結合された系列]: すべてのクエリの未加工データを一度に表示し、列ごとに結果セットを 1 つ表示します。列見出しをクリックしてデータをソートできます。

未加工のクエリ結果を CSV としてダウンロード

Grafana は、ブラウザのデフォルトのダウンロード場所に CSV ファイルを生成します。お好みのビューワーで開くことができます。

1. [Inspector] タブで、上記の手順に従って未加工のクエリ結果を取得します。

2. エクスポートする未加工データが表示されるまで、クエリ設定を絞り込みます。

3. [CSV のダウンロード] を選択します。

Excel 用にフォーマットされた CSV ファイルをダウンロードするには、[データオプション] を展開して [Excel 用にダウンロード] トグルをオンにしてから、[CSV のダウンロード] オプションを選択します。

ログ結果を TXT としてダウンロード

[Inspector] タブで [ログのダウンロード] を選択すると、現在表示しているログの TXT ファイルを生成できます。

トレース結果のダウンロード

データソースタイプに基づいて、Grafana は、サポートされている形式 (Jaeger、Zipkin、または OTLP 形式) のいずれかでトレース結果の JSON ファイルを生成します。

1. [Inspector] を開きます。

2. ログクエリの結果を検査します。エクスポートする未加工ログが表示されるまで、結果を絞り込みます。

3. [ログのダウンロード を選択します。

クエリパフォーマンスの検査

[統計] タブには、クエリにかかる時間、送信したクエリの数、返された行数を示す統計が表示されます。この情報は、特に数値が予想外に高い場合や低い場合のクエリのトラブルシューティングに役立ちます。

統計が読み取り専用形式で表示されます。

[JSON モデルの表示]

データだけでなく、データフレーム JSON モデルも探索してエクスポートできます。

JSON モデルを表示するには

1. インスペクターパネルで、[JSON] タブをクリックします。

2. [ソースの選択] ドロップダウンから、以下のいずれかのオプションを選択します。

   • [データ] – Explore に返されたデータを表す JSON オブジェクトを表示します。

   • [データフレーム構造] – 未加工の結果セットを表示します。

3. JSON の一部を展開または折りたたんで、個別のセクションを表示できます。[クリップボードにコピー] オプションを選択して、JSON 本文をコピーし、別のアプリケーションに貼り付けることもできます。

データソースへの未加工リクエストとレスポンスの表示

Explore と Inspector タブを操作すると、クエリで生成する未加工のリクエストとレスポンスデータを表示できます。Inspector で [クエリ] タブを選択し、[更新] を選択して未加工データを表示します。

Grafana はクエリをサーバーに送信し、結果を表示します。クエリの特定の部分をドリルダウン、そのすべてを展開または折りたたみ、またはデータをクリップボードにコピーして他のアプリケーションで使用できます。