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

データのクエリと変換

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

クエリについて

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

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

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

クエリエディタ

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

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

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

クエリ構文

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

[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 は自動的にデフォルトのデータソースを選択します。

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

クエリの管理

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

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

クエリオプション

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

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

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