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 である必要があります。Float*
• cumulative_bucket_value — ヒストグラムバケットの累積値です。値は、バケットの上限が増加するにつれて単調増加である必要があります。UInt* または Float*

戻り値

指定したレベルの 分位点 を返します。結果の浮動小数点型は bucket_upper_bound の型と一致します。Float32 または Float64

例

使用例

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));

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

関連項目

• median
• quantiles