quantilePrometheusHistogram

Introduit dans : v25.10.0

Calcule le quantile d’un histogramme à l’aide d’une interpolation linéaire, en tenant compte de la valeur cumulative et des bornes supérieures de chaque bucket de l’histogramme.

Pour obtenir la valeur interpolée, toutes les valeurs transmises sont combinées dans un tableau, puis triées selon les bornes supérieures de leur bucket correspondant. L’interpolation du quantile est ensuite effectuée de manière similaire à la fonction PromQL histogram_quantile() sur un histogramme classique, en réalisant une interpolation linéaire à partir des bornes inférieure et supérieure du bucket dans lequel se situe la position du quantile.

Voir aussi

Syntaxe

quantilePrometheusHistogram(level)(bucket_upper_bound, cumulative_bucket_value)

Paramètres

level — Facultatif. Niveau du quantile. Nombre à virgule flottante constant compris entre 0 et 1. Nous recommandons d'utiliser une valeur de level dans l'intervalle [0.01, 0.99]. Valeur par défaut : 0.5. Pour level=0.5, la fonction calcule la médiane. Float64

Arguments

bucket_upper_bound — Bornes supérieures des buckets de l'histogramme. Le bucket le plus élevé doit avoir une borne supérieure égale à +Inf. Float*
cumulative_bucket_value — Valeurs cumulées des buckets de l'histogramme. Les valeurs doivent être monotoniquement croissantes à mesure que la borne supérieure du bucket augmente. UInt* ou Float*

Valeur renvoyée

Renvoie le quantile du niveau spécifié. Le type à virgule flottante du résultat correspond à celui de bucket_upper_bound. Float32 ou Float64

Exemples

Exemple d'utilisation

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

Voir aussi