Simple Log Service:メトリクスデータのクエリと分析の構文

SQL の例： 詳細については、「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) が返すテーブルのスキーマ：

  フィールド	フィールドタイプ	説明
  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>	時系列。

  クエリ例：