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__ フィールドの値の合計を取得し、1 時間ごとにデータを集計します。

  *| 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) 関数によって返されるテーブルのスキーマを示します。

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

  クエリの例:

  • promql_query(string) 関数

  • promql_query_range(string, string) 関数

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

  フィールド	タイプ	説明
  label	varchar	ラベルキー。

  クエリの例:

  • promql_labels() 関数

  • promql_labels(string) 関数

  • promql_label_values(string) 関数

  • promql_label_values(string, string) 関数

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

  フィールド	タイプ	説明
  series	map<varchar, varchar>	時系列。

  クエリの例