クエリ - Amazon Managed Grafana
クエリエディタクエリ構文クエリタブ UIパネル間でのクエリ結果の共有

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

クエリ

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

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

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

Grafana ワークスペースパネルは、クエリを使用してデータソースと通信し、視覚化用のデータを取得します。クエリは、データソースで使用されるクエリ言語で記述された質問です。クエリが適切に形成されている場合、データソースは応答します。パネルデータソースオプションでは、クエリがデータソースに送信される頻度と収集されるデータポイントの数を調整できます。

Grafana ワークスペースは、パネルごとに最大 26 のクエリをサポートします。

クエリエディタ

クエリエディタは、クエリの記述に役立つフォームです。データソースによっては、クエリエディタによって自動補完、メトリクス名、または変数の提案が提供される場合があります。

クエリ言語が異なるため、データソースのクエリエディタは異なる場合があります。

クエリ構文

データソースには、データを要求するクエリ言語と構文が異なります。2 つのクエリの例を次に示します。

PostgreSQL 


SELECT hostname FROM host WHERE region IN($region)

PromQL 


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

データソースのクエリの記述の詳細については、そのデータソースのドキュメントを参照してください。データソースについては、「」を参照してくださいデータソースに接続する。

クエリタブ UI

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

  • データソースセレクタ

  • クエリオプション

  • クエリインスペクターボタン

  • クエリエディタのリスト

データソースセレクタ

データソースセレクタはドロップダウンリストです。追加したデータソースを選択するには、これを選択します。パネルを作成すると、Amazon Managed Grafana はデフォルトのデータソースを自動的に選択します。データソースの詳細については、「」を参照してくださいデータソースに接続する。

Grafana ワークスペースで設定したデータソースに加えて、3 つの特別なデータソースを使用できます。

  • TestDataDB – ランダムなウォークデータを生成する組み込みデータソース。Grafana データソースは、視覚化のテストや実験の実行に役立ちます。

  • 混合 – 同じパネル内の複数のデータソースをクエリするためのデータソース。このデータソースを選択すると、追加する新しいクエリごとにデータソースを選択できます。

    • 最初のクエリでは、混合 を選択する前に選択したデータソースを使用します。

    • 混合データソースを使用するように既存のクエリを変更することはできません。

  • ダッシュボード – 同じダッシュボード内の別のパネルの結果セットを使用するためのデータソース。

クエリオプション

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

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

次のパネルデータソースクエリオプションを使用できます。

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

    ポイント数を制限する主な理由は、パフォーマンスとラインのスムーズ化の 2 つです。デフォルト値はグラフの幅 (またはピクセル数) です。これにより、グラフパネルが表示できる量よりも多くのデータポイントがなくなります。

    ストリーミングデータでは、最大データポイント値がローリングバッファに使用されます。（ストリーミングはデータの継続的なフローであり、バッファリングはストリームをチャンクに分割する方法です）。

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

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

    Amazon Managed Grafana は、テンプレートクエリの変数として使用できる適切な間隔を自動的に計算します。変数は、秒: $__interval、またはミリ秒: のいずれかです$__interval_ms。通常、 sumや などの集計関数で使用されますaverage。例えば、これは間隔変数 を使用した Prometheus クエリですrate(http_requests_total[$__interval])。

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

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

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

  • タイムシフト — 個々のパネルの時間範囲を上書きする別の方法を提供します。この関数は相対時間範囲でのみ機能し、時間範囲を調整できます。

    例えば、パネルの時間範囲をダッシュボードのタイムピッカーより 2 時間早くシフトできます。詳細については、「時間範囲コントロール」を参照してください。

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

クエリインスペクターボタン

クエリインスペクターを選択して、パネルインスペクターのクエリタブを開くことができます。クエリタブには、パネルから送信されたクエリリクエストとレスポンスが表示されます。

更新を選択すると、このパネルからサーバーに送信されたリクエストの全文が表示されます。

注記

クエリインスペクターが結果を返すには、少なくとも 1 つのクエリを追加する必要があります。

パネルインスペクターの詳細については、「」を参照してくださいパネルの検査。

クエリエディタのリスト

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

パネル間でのクエリ結果の共有

Amazon Managed Grafana では、ダッシュボード内の他のパネルに対して、1 つのパネルからのクエリ結果を使用できます。パネル間でクエリ結果を共有すると、データソースに対して実行されるクエリの数が減少し、ダッシュボードのパフォーマンスが向上します。

ダッシュボードデータソースでは、結果を共有するクエリを含むダッシュボード内のパネルを選択できます。パネルごとに個別のクエリを送信する代わりに、Amazon Managed Grafana は 1 つのクエリを送信し、他のパネルはクエリ結果を使用して視覚化を構築します。

この戦略では、例えば、同じデータを視覚化する複数のパネルがある場合に実行されるクエリの数を大幅に減らすことができます。

データソースクエリを別のパネルと共有するには

  1. ダッシュボードを作成します。詳細については、「ダッシュボードの作成」を参照してください。

  2. パネルを追加します。詳細については、「パネルの追加」を参照してください。

  3. タイトルを に変更しますSource panel。このパネルを他のパネルのソースとして使用します。共有するクエリを定義します。現時点で利用可能なデータソースがない場合は、Grafana データソースを使用できます。Grafana データソースは、テストに使用できるランダムな時系列を返します。

  4. 2 番目のパネルを追加し、クエリエディタで Dashboard データソースを選択します。

  5. 「パネルリストから結果を使用する」で、作成した最初のパネルを選択します。

ソースパネルで定義されたすべてのクエリが、新しいパネルで使用できるようになりました。ソースパネルで行われたクエリは、複数のパネルと共有できます。

クエリが定義されているパネルに移動するには、そのクエリを選択します。