データのクエリと変換 - Amazon Managed Grafana
クエリについてクエリタブに移動するクエリを追加するクエリの管理クエリオプション

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

データのクエリと変換

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

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

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

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 、Mixed 、Dashboard の 3 つの特別なデータソースも含まれています。 詳細については、「データソース」を参照してください。

クエリタブに移動する

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

  • データソースセレクタ — クエリするデータソースを選択します。

  • クエリオプション： — 最大データ取り出しパラメータとクエリ実行時間間隔を設定します。

  • クエリインスペクターボタン： — クエリインスペクターパネルを開き、クエリを表示および最適化できます。

  • クエリエディタリスト： — 作成したクエリを一覧表示します。

  • 式： — expression builder を使用してアラート式を作成します。式の詳細については、「式クエリの書き込み」を参照してください。

クエリを追加する

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

クエリを追加するには

  1. クエリを追加するパネルを編集します。

  2. [Queries] (クエリ) タブを開きます。

  3. データソースドロップダウンメニューを選択し、データソースを選択します。

  4. クエリオプションを選択して、必要なデータポイントの最大数を設定します。クエリオプションの詳細については、「」を参照してくださいクエリオプション。

  5. クエリエディタを使用してクエリを書き込みます。

  6. [適用] を選択します。

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

クエリの管理

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

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

クエリオプション

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

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

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

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

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

    ストリーミングデータでは、Grafana はローリングバッファの最大データポイント値を使用します。ストリーミングはデータの継続的なフローであり、バッファリングはストリームをチャンクに分割します。例えば、Loki はライブテールモードでデータをストリーミングします。

  • 最小間隔 — 自動的に計算される間隔の最小制限を設定します。通常は最小スクレイプ間隔です。データポイントが 15 秒ごとに保存される場合、それよりも間隔を短くしてもメリットはありません。また、これをスクレイプ間隔よりも高い最小値に設定して、より粗く機能するクエリを取得することもできます。

  • 間隔 – データポイントを時間ごとに集計またはグループ化するときに使用できる時間範囲を設定します。

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

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

    この自動間隔は、グラフの幅に基づいて計算されます。ユーザーが視覚化を拡大すると、間隔が大きくなり、より粗粒度の集計になります。同様に、ユーザーがズームインすると間隔が短くなり、よりきめ細かな集計になります。

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

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

    注記

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

    例 相対時間フィールド

    過去 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

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