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 の名前を指定します。

  説明

  テーブル名は二重引用符 ("") で囲んでください。

• __labels__ フィールドからキーの値を取得するには、element_at() 関数を使用します。例： 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) 関数

    クエリエディタに *| select promql_query('up') from metrics を入力し、[検索 & 分析] をクリックします。クエリ結果として、time、metric、labels、value の 4 つの列を持つテーブルが返され、各インスタンスの up メトリック値が表示されます。

  • promql_query_range(string, string) 関数

    SQL ステートメント select promql_query_range('up', '30s') from metrics を実行して、PromQL メトリック up の範囲データを step 30s でクエリします。クエリ結果は、時系列データを示すテーブルとして表示されます。

• promql_labels()、promql_labels(string)、promql_label_values(string)、および promql_label_values(string, string) が返すテーブルスキーマ：

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

  クエリの例：

  • promql_labels() 関数

    *| select promql_labels() from metrics。クエリ結果として label 列が返され、code、instance、job、le、method の 5 つのラベル名が含まれます。

  • promql_labels(string) 関数

    たとえば、クエリ *| select promql_labels('up') from metrics を実行して、up メトリックのすべてのラベル名をクエリします。結果には __name__、instance、および job が含まれます。

  • promql_label_values(string) 関数

    たとえば、クエリ *| select promql_label_values('instance') from metrics を実行します。クエリ結果の label 列には、demo.promlabs.com:10000、demo.promlabs.com:10001、demo.promlabs.com:10002 の 3 つのインスタンスアドレスが返されます。

  • promql_label_values(string, string) 関数

    クエリの例： *| select promql_label_values('up{demo!="a"}','instance') from metrics。クエリ結果は、demo.promlabs.com:10000、demo.promlabs.com:10001、demo.promlabs.com:10002 の 3 行を含む label 列を返します。

• promql_series(string) が返すテーブルスキーマ：

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

  クエリの例：

  たとえば、クエリ *| select promql_series('up') from metrics を実行します。結果の series 列には、demo.promlabs.com:10001、demo.promlabs.com:10000、demo.promlabs.com:10002 に対応する 3 行が含まれます。各行は、instance、__name__ (値： up)、および job (値： demo) フィールドを含むマップです。