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の場合、この関数は中央値を計算します。

• 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