データのクエリと変換

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

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

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

Grafana は、さまざまなタイプのデータソースをサポートしています。データソース[クエリ]は、Grafana が変換および視覚化できるデータを返します。各データソースは独自のクエリ言語を使用し、データソースプラグインはそれぞれクエリエディタと呼ばれるクエリ構築ユーザーインターフェイスを実装します。

クエリについて

Grafana パネルは、クエリを介してデータソースと通信します。このクエリは、視覚化用のデータを取得します。クエリは、データソースで使用されるクエリ言語で記述された質問です。

パネルのデータソースオプションで、クエリの頻度とデータ収集の制限を設定できます。Grafana は、パネルごとに最大 26 個のクエリをサポートします。

各データソースのクエリ言語の詳細については、「データソース」セクションを参照してください。

クエリエディタ

各データソースのクエリエディタには、独自の機能を活用するクエリの作成に役立つカスタマイズされたユーザーインターフェイスが用意されています。

クエリ言語の違いにより、各データソースクエリエディタの外観と関数は異なります。データソースによっては、クエリエディタが自動補完機能、メトリクス名、変数の提案、ビジュアルクエリ構築インターフェイスを提供する場合があります。

特定のデータソースの一意のクエリエディタ機能の詳細については、以下の各ドキュメントを参照してください。

Grafana に含まれるデータソースについては、「組み込みデータソース」を参照してください。
Grafana Enterprise の編集に含まれるデータソースについては、「Enterprise データソースに接続する」を参照してください。

クエリ構文

データソースは、異なるクエリ言語を使用してデータをリクエストします。特定のデータソースの一意のクエリ言語の詳細については、各ドキュメントを参照してください。

[PostgreSQL の例]:


SELECT hostname FROM host WHERE region IN($region)

PromQL の例:


query_result(max_over_time(<metric>[${__range_s}s]) != <state>)

[特別なデータソース]

Grafana には、[Grafana]、[混合]、および [ダッシュボード] の 3 つの特別なデータソースも含まれています。詳細については、「データソース」を参照してください。

クエリタブを操作する

パネルの [クエリ] タブは、次の要素で構成されます。

[データソースセレクタ] – クエリが実行されるデータソースを選択します。
[クエリオプション] — 最大データ取得パラメータとクエリ実行時間間隔を設定します。
[クエリインスペクターボタン] — クエリインスペクターパネルを開き、クエリを表示および最適化できます。
[クエリエディタリスト]: – 作成したクエリを一覧表示します。
[式]: – 式ビルダーを使用してアラート式を作成します。式の詳細については、「クエリ式の書き込み」を参照してください。

クエリの追加

クエリは、Grafana がダッシュボードパネルで視覚化するデータを返します。パネルを作成すると、Grafana は自動的にデフォルトのデータソースを選択します。

クエリを追加するには

クエリを追加するパネルを編集します。
[クエリ] タブを選択します。
[データソース] ドロップダウンメニューを選択し、データソースを選択します。
[クエリオプション] を選択して、必要なデータポイントの最大数を設定します。クエリオプションの詳細については、「クエリオプション」を参照してください。
クエリエディタを使用してクエリを書き込みます。
[Apply] (適用) を選択します。

Grafana はデータソースにクエリを実行し、データを視覚化します。

クエリの管理

Grafana は、クエリを折りたたみ可能なクエリ行に整理します。各クエリ行にはクエリエディタが含まれ、文字 (A、B、C など) で識別されます。

クエリを管理するには、クエリのコピー、クエリの非表示、クエリの削除、クエリの順序変更、クエリエディタのヘルプの切り替えを行うことができます。

クエリオプション

データソースセレクタの横にある [クエリオプション] を選択すると、選択したデータソースの設定が表示されます。ここで行った変更は、このパネルで行われたクエリにのみ影響します。

Grafana は、ダークグレーテキストで表示されるデフォルトを設定します。変更はホワイトテキストで表示されます。フィールドをデフォルト設定に戻すには、フィールドからホワイトテキストを削除します。

パネルデータソースのクエリオプションには以下が含まれます。

[最大データポイント数] – データソースがサポートしている場合、返される各系列の最大データポイント数を設定します。クエリが最大データポイント設定よりも多くのデータポイントを返す場合、データソースは、平均、最大、または別の関数でデータポイントを集約することで、返されるポイント数を減らします。

ポイントの数を制限して、クエリのパフォーマンスを向上させたり、視覚化された行を平滑にしたりできます。デフォルト値はグラフの幅 (またはピクセル数) です。グラフパネルに表示されるスペースと同じ数のデータポイントしか視覚化できないためです。

ストリーミングデータでは、Grafana はローリングバッファの最大データポイント値を使用します。ストリーミングはデータの継続的なフローであり、バッファリングはストリームをチャンクに分割します。例えば、Loki はライブテーリングモードでデータをストリーミングします。
[最小間隔] – 自動計算された間隔の最小制限を設定します。これは通常、最小スクレイプ間隔です。データポイントを 15 秒ごとに保存する場合、それよりも間隔を短くしてもメリットはありません。また、スクレイプ間隔よりも低い最小値に設定して、粗く適切に機能するクエリを取得することもできます。
[間隔] – データポイントを時間別に集計またはグループ化するときに使用できる時間範囲を設定します。

Grafana は、テンプレートクエリで変数として使用できる適切な間隔を自動的に計算します。変数は、秒 ($__interval) またはミリ秒 ($__interval_ms) で測定されます。

間隔は通常、合計や平均などの集計関数で使用されます。例えば、これは間隔変数 rate(http_requests_total[$__interval]) を使用する Prometheus クエリです。

この自動間隔は、グラフの幅に基づいて計算されます。ユーザーがグラフを縮小すると、間隔が大きくなり、より粗視化された集計になります。同様に、ユーザーが拡大すると、間隔が短くなり、より高精細な集計になります。

詳細については、「グローバル変数」を参照してください。

[相対時間] – 個々のパネルの相対時間範囲をオーバーライドします。これにより、パネルは、ダッシュボードの右上隅にあるダッシュボードタイムピッカーで選択されている時間とは異なります。これを使用して、同じダッシュボードに異なる期間または日数のメトリクスを表示できます。

注記

ダッシュボードの時間範囲が絶対時間である場合、パネルの時間オーバーライドは効果がありません。

例	相対時間フィールド
過去 5 分間	`now-5m`
今日のこれまでのところ	`now/d`
過去 5 日間	`now-5d/d`
今週始めから現在まで	`now/w`
過去 2 年間	`now-2y/y`

[タイムシフト] – タイムピッカーに対して開始と終了をシフトすることで、個々のパネルの時間範囲をオーバーライドします。例えば、パネルの時間範囲をダッシュボードのタイムピッカーより 2 時間早くシフトできます。

注記

ダッシュボードの時間範囲が絶対時間である場合、パネルの時間オーバーライドは効果がありません。

例	タイムシフトフィールド
過去丸 1 週間	`1w/w`
丸 2 週間前	`2w/w`
過去丸 1 か月間	`1M/M`
この丸 1 年	`1d/y`
過去丸 1 年間	`1y/y`

[キャッシュタイムアウト] – (データソースで使用可能な場合のみ表示) 時系列ストアにクエリキャッシュがある場合、デフォルトのキャッシュタイムアウトをオーバーライドします。この値を秒単位で数値として指定します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

標準オプションを設定する

クエリ式の書き込み