Simple Log Service:メトリックデータのクエリと分析の概要

次の例は、SQL構文の使用方法を示しています。

• すべてのデータを照会および分析します。

  *| SELECT * FROM "my_metric_store.prom" WHERE __name__ != '' 

• http_request_countメトリックの場合、__labels __, 'domainフィールドの値がwww.example.comされているデータを照会し、__value__ フィールドの値の合計を取得します。

  *| SELECT sum(__value__) FROM "my_metric_store.prom" WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com' 

• http_request_countメトリックでは、__labels __, 'domainフィールドの値がwww.example.comされているデータを照会し、__value__ フィールドの値の合計を取得し、データを時間単位で集計します。

  *| SELECT sum(__value__),date_trunc('hour', __time_nano__/1000000) as t
  FROM "my_metric_store.prom" 
  WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com'
  GROUP BY t
  ORDER BY t DESC

次のリストでは、SQL構文について説明します。

• メトリックデータのSQL構文は、ログデータのSQL構文と同じです。 詳細については、「ログ分析の概要」をご参照ください。 SQL構文を使用してメトリックデータをクエリおよび分析する場合、FROM句のテーブル名は {metrics_store_name}.prom形式である必要があります。 {metrics_store_name} は、作成するMetricstoreの名前を指定します。

  説明

  テーブル名を二重引用符 ("") で囲む必要があります。

• element_at() 関数を使用して、__labels__ フィールドからキーの値を取得できます。 例: element_at(__labels __, 'key')

• テーブルスキーマの詳細については、「エンコード形式」をご参照ください。

PromQL関数は、ユーザー定義テーブル生成関数 (UDTF) に似ており、テーブルを返します。

• 次の表に、promql_query(string) またはpromql_query_range(string, string) 関数によって返されるテーブルのスキーマを示します。

  項目	データ型	説明
  測定値	varchar	時系列のメトリック名。 GROUP BY句がクエリ文に含まれている場合、このフィールドは空になる可能性があります。
  labels	map<varchar, varchar>	ラベル。 値はマップです。
  time	bigint	時間だ
  value	double	特定の時点での値。

  クエリの例:

  • promql_query (文字列) 関数

  • promql_query_range (文字列、文字列) 関数

• 次の表に、promql_labels() 、promql_labels(string) 、promql_label_values(string) 、またはpromql_label_values(string, string) 関数によって返されるテーブルのスキーマを示します。

  項目	データ型	説明
  ラベル	varchar	ラベルキー。

  クエリの例:

  • promql_labels() 関数

  • promql_labels (文字列) 関数

  • promql_label_values (文字列) 関数

  • promql_label_values (文字列、文字列) 関数

• 次の表に、promql_series(string) 関数によって返されるテーブルのスキーマを示します。

  項目	データ型	説明
  シリーズ	map<varchar, varchar>	時系列。

  クエリの例