quantilePrometheusHistogram

線形補間を用いてヒストグラムの分位数を計算します。各ヒストグラムバケットの累積値と上限値を考慮します。

補間された値を得るために、入力されたすべての値を配列にまとめ、その配列を対応するバケットの上限値でソートします。その後、通常のヒストグラムに対する PromQL の histogram_quantile() 関数と同様に分位数の補間を行い、分位点が位置するバケットの下限値と上限値を用いて線形補間を実施します。

構文

quantilePrometheusHistogram(level)(bucket_upper_bound, cumulative_bucket_value)

引数

• level — 分位数のレベル。省略可能なパラメータ。0 から 1 の範囲の定数の浮動小数点数。level の値として [0.01, 0.99] の範囲を使用することを推奨します。デフォルト値: 0.5。level=0.5 の場合、この関数は median を計算します。

• bucket_upper_bound — ヒストグラムバケットの上限。

  • 最も大きいバケットは上限として +Inf を持たなければなりません。

• cumulative_bucket_value — ヒストグラムバケットの累積 UInt または Float64 の値。

  • バケットの上限が大きくなるにつれて、値は単調増加していなければなりません。

返される値

• 指定されたレベルの分位数。

型:

• Float64。

例

入力テーブル:

   ┌─bucket_upper_bound─┬─cumulative_bucket_value─┐
1. │                  0 │                       6 │
2. │                0.5 │                      11 │
3. │                  1 │                      14 │
4. │                inf │                      19 │
   └────────────────────┴─────────────────────────┘

結果：

   ┌─quantilePrometheusHistogram(bucket_upper_bound, cumulative_bucket_value)─┐
1. │                                                                     0.35 │
   └──────────────────────────────────────────────────────────────────────────┘

関連項目

• median
• quantiles