quantilePrometheusHistogram

Introduzido em: v25.10.0

Calcula o quantil de um histograma usando interpolação linear, levando em conta o valor cumulativo e os limites superiores de cada bucket do histograma.

Para obter o valor interpolado, todos os valores fornecidos são combinados em um array, que é então ordenado de acordo com os valores correspondentes de limite superior do bucket. A interpolação do quantil é então realizada de forma semelhante à função PromQL histogram_quantile() em um histograma clássico, executando uma interpolação linear com base nos limites inferior e superior do bucket em que a posição do quantil é encontrada.

Veja também

• median
• quantiles

Sintaxe

quantilePrometheusHistogram(level)(bucket_upper_bound, cumulative_bucket_value)

Parâmetros

• level — Opcional. Nível do quantil. Número de ponto flutuante constante entre 0 e 1. Recomendamos usar um valor de level no intervalo [0.01, 0.99]. Valor padrão: 0.5. Em level=0.5, a função calcula a mediana. Float64

Argumentos

• bucket_upper_bound — Limites superiores dos buckets do histograma. O bucket mais alto deve ter um limite superior de +Inf. Float*
• cumulative_bucket_value — Valores cumulativos dos buckets do histograma. Os valores devem aumentar monotonicamente à medida que o limite superior do bucket aumenta. UInt* ou Float*

Valor retornado

Retorna o quantil do nível especificado. O tipo de ponto flutuante do resultado corresponde ao tipo de bucket_upper_bound. Float32 ou Float64

Exemplos

Exemplo de uso

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 │
└──────────────────────────────────────────────────────────────────────────┘

Veja também

• median
• quantiles