quantilePrometheusHistogram

線形補間によりヒストグラムの分位点を計算します。

​

quantilePrometheusHistogram

導入バージョン: v25.10.0

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

補間値を取得するには、渡されたすべての値を1つの配列にまとめ、その後、対応するバケットの上限境界値でソートします。 続いて、分位点の位置が見つかったバケットの下限と上限を使って線形補間を行い、クラシックヒストグラムに対する PromQL の histogram_quantile() 関数と同様に分位点補間を実行します。

関連項目

• median
• quantiles

構文

quantilePrometheusHistogram(level)(bucket_upper_bound, cumulative_bucket_value)

パラメータ

• level — 任意。分位点 のレベルです。0 以上 1 以下の定数浮動小数点数です。level には [0.01, 0.99] の範囲の値を使用することを推奨します。デフォルト値: 0.5。level=0.5 の場合、この関数は 中央値 を計算します。Float64

引数

• bucket_upper_bound — ヒストグラムバケットの上限値です。最も大きいバケットの上限は +Inf である必要があります。Float64
• cumulative_bucket_value — ヒストグラムバケットの累積値です。値は、バケットの上限が増加するにつれて単調増加である必要があります。(U)Int* または Float64

戻り値

指定したレベルの 分位点 を返します。Float64

例

使用例

Query

SELECT quantilePrometheusHistogram(bucket_upper_bound, cumulative_bucket_value)
FROM VALUES('bucket_upper_bound Float64, cumulative_bucket_value UInt64', (0, 6), (0.5, 11), (1, 14), (inf, 19));

Response

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

関連項目

• median
• quantiles