サポートされている PromQL の機能

ラベル付きメトリックは、PromQL クエリ言語を用いてグラフに表示できます。Mackerel では、PromQL の以下の機能がサポートされています。

時系列セレクタ

• ベクトルセレクタ
  • =（等号ラベルマッチャ）
  • !=（不等号ラベルマッチャ）
  • =~（正規表現ラベルマッチャ）
  • !~（否定正規表現ラベルマッチャ）
• 範囲ベクトルセレクタ

修飾子

• offset
• @

集計演算子

• sum()
• avg()
• min()
• max()
• quantile()
• count()
• count_values()

また、集計に用いるラベルを制御する by・without 修飾子に対応しています。

二項演算子

(vector) x (vector)、(vector) x (scalar)、(scalar) x (vector)、(scalar) x (scalar) の 4 パターンで定義されます。

ベクトル同士の演算を実現するために、ベクトルマッチングという仕組みが実装されています。一対一対応（算術・比較演算子）と多対多対応（集合演算子）は既に実装が完了しています。

group_left・group_right 修飾子を用いた一対多対応は未実装です。

算術演算子

• +（加算）
• -（減算）
• \*（乗算）
• /（除算）
• %（剰余算）
• ^（冪乗）

比較演算子

• ==
• !=
• >
• >=
• <
• <=

集合演算子

• and（積集合）
• or（和集合）
• unless（差集合）

関数

カウンタ用の計算関数

• irate()
• increase()

<aggregation>_over_time 関数

• avg_over_time()
• sum_over_time()
• count_over_time()
• last_over_time()
• present_over_time()

ラベル関数

• label_join()
• label_replace()

型変換関数

• vector()
• scalar()