Passer au contenu principal

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. Float64
  • 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. (U)Int* ou Float64
Valeur renvoyée Renvoie le quantile du niveau spécifié. Float64 Exemples Exemple d’utilisation
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 │
└──────────────────────────────────────────────────────────────────────────┘
Voir aussi
Dernière modification le 25 juin 2026