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

PostgreSQL データソースに接続する

PostgreSQL データソースを使用して、Amazon Aurora PostgreSQL データベースからのデータをクエリおよび視覚化できます。

データソースの追加

データソースオプション

最小時間間隔

$_interval $_interval_ms 変数の下限。データを毎分書き込む1m場合など、書き込み頻度に設定することをお勧めします。このオプションは、データソースオプションのダッシュボードパネルで上書き/設定することもできます。この値は、 (1 分) や (30s30 秒) など、1m有効な時間識別子が続く数値としてフォーマットする必要があります。次の時間識別子がサポートされています。

データベースユーザーのアクセス許可

次のコード例は、アクセス許可が制限された特定の PostgreSQL ユーザーの作成を示しています。

 CREATE USER grafanareader WITH PASSWORD 'password';
 GRANT USAGE ON SCHEMA schema TO grafanareader;
 GRANT SELECT ON schema.table TO grafanareader;

ユーザーがパブリックロールから不要なアクセス許可を取得していないことを確認します。

クエリエディタ

PostgreSQL クエリエディタは、グラフまたは Singlestat パネルの編集モードのメトリクスタブにあります。パネルタイトルを選択して編集モードに入り、編集します。

クエリエディタには、パネル編集モードでクエリが実行された後に表示される生成 SQL リンクがあります。これを選択すると、実行された未加工の補間された SQL 文字列が展開されて表示されます。

テーブル、時間列、メトリクス列 (FROM) を選択する

初めて編集モードに入るか、新しいクエリを追加すると、Grafana はタイムスタンプ列と数値列を持つ最初のテーブルをクエリビルダーに事前入力しようとします。

FROM フィールドで、Grafana はデータベースユーザーの search_path にあるテーブルを提案します。にないテーブルまたはビューを選択するには、search_path などの完全修飾名 (schema.table) を手動で入力できますpublic.metrics。

Time 列フィールドは、時間値を保持する列の名前を参照します。メトリクス列フィールドの値の選択はオプションです。値を選択すると、メトリクス列フィールドがシリーズ名として使用されます。

メトリクス列の候補には、テキストデータ型 (char、varchar、text) の列のみが含まれます。メトリクス列として異なるデータ型の列を使用するには、キャスト を使用して列名を入力しますip::text。などのテキストデータ型に評価されるメトリクス列フィールドに任意の SQL 式を入力することもできますhostname || ' ' || container_name。

列、ウィンドウ、集計関数 (SELECT)

SELECT 行では、使用する列と関数を指定できます。列フィールドでは、 などの列名の代わりに任意の式を記述できますcolumn1 * column2 / column3。

クエリエディタで使用できる関数は、データソースの設定時に選択した PostgreSQL のバージョンによって異なります。集計関数を使用する場合は、結果セットをグループ化する必要があります。集計関数を追加すると、エディタは自動的に を追加しますGROUP BY time。

エディタは、クエリのこの部分を簡素化して統合しようとします。

さらに値列を追加するには、プラスボタンを選択し、メニューから列を選択します。グラフパネルには、複数の値列が別々のシリーズとしてプロットされます。

データのフィルタリング (WHERE)

フィルターを追加するには、WHERE条件の右側にあるプラスアイコンを選択します。フィルターを削除するには、フィルターを選択し、 の削除を選択します。現在選択されている時間範囲のフィルターが新しいクエリに自動的に追加されます。

グループ化の基準

時間または他の列でグループ化するには、GROUP BY 行の末尾にあるプラスアイコンを選択します。提案ドロップダウンリストには、現在選択されているテーブルのテキスト列のみが表示されますが、手動で任意の列を入力できます。項目を選択し、 の削除 を選択すると、グループを削除できます。

グループ化を追加する場合、選択したすべての列に集計関数が適用されている必要があります。グループ化を追加すると、クエリビルダーは集計関数なしですべての列に集計関数を自動的に追加します。

ギャップ埋め

Amazon Managed Grafana は、時間別にグループ化すると、欠損値を入力できます。時間関数は 2 つの引数を受け入れます。最初の引数はグループ化する時間枠で、2 番目の引数は Grafana で欠落している項目を埋める値です。

テキストエディタモード (RAW)

raw クエリエディタモードに切り替えるには、ハンバーガーアイコンを選択し、エディタモードを切り替えるか、クエリの下にある SQL の編集を選択します。

マクロ

マクロはクエリ内で使用して構文を簡素化し、動的部分を可能にします。

テーブルクエリ

クエリオプションがテーブル としてフォーマットに設定されている場合、基本的に任意のタイプの SQL クエリを実行できます。テーブルパネルには、クエリが返す列と行の結果が自動的に表示されます。

通常の as SQL 列選択構文を使用して、テーブルパネル列の名前を制御できます。

時系列クエリ

Format を に設定した場合Time series、例えばグラフパネルで使用するには、クエリは SQL 日時または Unix エポックを表す任意の数値データ型を返timeす という名前の列を返す必要があります。time と を除くすべての列metricは、値列として扱われます。値列のメトリクス名として使用される metric という名前の列を返すことができます。複数の値列と という名前の列を返す場合metric、この列はシリーズ名のプレフィックスとして使用されます。

時系列クエリの結果セットは、時間でソートする必要があります。

次のコード例は、metric列を示しています。

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double"),
  'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

次のコード例では、$__timeGroup マクロの fill パラメータを使用して、代わりに null 値をゼロに変換しています。

SELECT
  $__timeGroup("createdAt",'5m',0),
  sum(value) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time

次のコード例は、複数の列を示しています。

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double") as "min_value",
  max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

テンプレート

メトリクスクエリでサーバー、アプリケーション、センサー名などのモノをハードコーディングする代わりに、代わりに変数を使用できます。変数は、ダッシュボードの上部にドロップダウン選択ボックスとして表示されます。これらのドロップダウンボックスを使用して、ダッシュボードに表示されるデータを変更できます。

テンプレート変数とテンプレート変数の詳細については、「」を参照してくださいテンプレート。

クエリ変数

タイプのテンプレート変数を追加するとQuery、測定名、キー名、キー値などの項目を返す PostgreSQL クエリを記述できます。このクエリはドロップダウン選択ボックスとして表示されます。

例えば、テンプレート変数 Query 設定でこのようなクエリを指定した場合、テーブル内のhostname列のすべての値を含む変数を使用できます。

SELECT hostname FROM host

クエリは複数の列を返すことができ、Grafana は自動的にそれらからリストを作成します。例えば、次のクエリは、 hostnameおよび の値を含むリストを返しますhostname2。

SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city

クエリ$__timeFilter(column)で などの時間範囲に依存するマクロを使用するには、テンプレート変数の更新モードを時間範囲変更 に設定する必要があります。

SELECT event_name FROM event_log WHERE $__timeFilter(time_column)

もう 1 つのオプションは、キー/値変数を作成できるクエリです。クエリは、 __textおよび という名前の 2 つの列を返す必要があります__value。__text 列の値は一意である必要があります (一意でない場合は、最初の値が使用されます）。ドロップダウンリストのオプションには、わかりやすい名前をテキストとして、ID を値として指定できるテキストと値があります。をテキストhostname、 を値idとするクエリの例：

SELECT hostname AS __text, id AS __value FROM host

ネストされた変数を作成することもできます。という名前の変数を使用するとregion、ホスト変数に現在選択されているリージョンのホストのみを表示させることができます。次のコード例は、このようなクエリを示しています ( regionが複数値変数の場合は、複数の値と照合=するのではなく、IN比較演算子を使用します）。

SELECT hostname FROM host  WHERE region IN($region)

__searchFilter を使用してクエリ変数で結果をフィルタリングする

クエリフィールド__searchFilterで を使用すると、ドロップダウン選択ボックスでユーザーが入力した内容に基づいてクエリ結果がフィルタリングされます。ユーザーによって何も入力されていない場合、 のデフォルト値は __searchFilterです%。

次の例は、 をクエリフィールド__searchFilterの一部として使用して検索を有効にする方法を示しています。hostnameドロップダウン選択ボックスのユーザータイプ。

SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'

クエリでの変数の使用

テンプレート変数の値は、テンプレート変数が の場合にのみ引用符で囲まれますmulti-value。

変数が複数値変数の場合は、複数の値と照合=するのではなく、IN比較演算子を使用します。

次の 2 つの構文があります。

$<varname> という名前のテンプレート変数の例hostname：

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

[[varname]] という名前のテンプレート変数の例hostname：

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC

複数値変数の引用を無効にする

Amazon Managed Grafana は、複数値変数の引用符で区切られたカンマ区切りの文字列を自動的に作成します。例えば、 server01と server02を選択した場合、 の形式になります'server01', 'server02'。引用を無効にするには、変数に csv フォーマットオプションを使用します。

${servers:csv}

可変フォーマットオプションの詳細については、「」を参照してくださいテンプレートと変数。

‏注釈

注釈を使用して、グラフの上に豊富なイベント情報をオーバーレイします。ダッシュボードメニュー/注釈ビューを使用して注釈クエリを追加します。詳細については、「‏注釈」を参照してください。

次のサンプルコードは、エポック値を持つ時間列を使用したクエリを示しています。

SELECT
  epoch_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

次のサンプルコードは、エポック値を持つ時間および時間終了列を使用したリージョンクエリを示しています。

SELECT
  epoch_time as time,
  epoch_time_end as timeend,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

次のコード例は、ネイティブ SQL 日付/時刻データ型の時間列を使用したクエリを示しています。

SELECT
  native_date_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)

アラート

時系列クエリはアラート条件で機能する必要があります。テーブル形式のクエリは、アラートルール条件ではまだサポートされていません。