quantilePrometheusHistogram

선형 보간을 사용해 히스토그램의 분위수를 계산합니다.

​

quantilePrometheusHistogram

도입 버전: v25.10.0

각 히스토그램 버킷의 누적값과 상한을 고려하여, 선형 보간으로 히스토그램의 분위수를 계산합니다.

보간된 값을 구하기 위해 전달된 모든 값을 하나의 배열로 합친 다음, 해당 버킷의 상한값에 따라 정렬합니다. 그 후 클래식 히스토그램에서 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