Skip to main content

​
timeSeriesQuantileToGrid

Introduit dans : v26.9.0 Fonction d’agrégation qui prend en entrée des données de séries temporelles sous forme de paires timestamp/valeur et calcule la fonction PromQL quantile_over_time sur une grille temporelle régulière définie par un timestamp de début, un timestamp de fin et un pas. Pour chaque point de la grille, les échantillons utilisés pour calculer le quantile sont ceux compris dans la fenêtre temporelle spécifiée. Le quantile est calculé selon la méthode R-7 (inclusive), comme pour quantileExactInclusive. Contrairement à quantileExactInclusive, les échantillons NaN ne sont pas ignorés : comme dans Prometheus, ils sont conservés et placés avant toute valeur réelle lors du tri. Ainsi, la médiane d’une fenêtre [1, NaN, 2] vaut 1, et une fenêtre dont tous les échantillons sont NaN renvoie NaN. Le niveau de quantile est passé en dernier argument, après les échantillons : soit un nombre unique utilisé pour tous les points de la grille, soit un tableau contenant un nombre par point de la grille. Il doit être identique pour toutes les lignes. Comme dans Prometheus, un niveau inférieur à 0 renvoie -Inf, un niveau supérieur à 1 renvoie +Inf et un niveau NaN renvoie NaN pour chaque point de la grille dont la fenêtre contient des échantillons.
Cette fonction est en aperçu privé ; activez-la en définissant enable_time_series_aggregate_functions=true.
Syntaxe
Paramètres
  • start_timestamp — Indique le début de la grille. Il peut également s’agir d’un nombre fractionnaire, ou d’une string contenant un nombre ou une date-heure au format texte. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • end_timestamp — Indique la fin de la grille. Il peut également s’agir d’un nombre fractionnaire, ou d’une string contenant un nombre ou une date-heure au format texte. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • grid_step — Indique le pas de la grille, en secondes. Il peut également s’agir d’un nombre fractionnaire, ou d’une string contenant un nombre ou une durée telle que ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
  • staleness — Indique l’ancienneté maximale (« staleness »), en secondes, des échantillons pris en compte. La fenêtre d’ancienneté est un intervalle ouvert à gauche et fermé à droite. Il peut également s’agir d’un nombre fractionnaire, ou d’une string contenant un nombre ou une durée telle que ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
Arguments
  • timestamp — Timestamp de l’échantillon. Il peut s’agir de valeurs individuelles ou de tableaux. UInt32 ou DateTime ou DateTime64 ou Array(UInt32) ou Array(DateTime) ou Array(DateTime64)
  • value — Valeur de la série temporelle correspondant au timestamp. Il peut s’agir de valeurs individuelles ou de tableaux. Float* ou Array(Float*)
  • samples — Échantillons de la série temporelle transmis sous forme de tableau de tuples (timestamp, value), dont les éléments ont les types de timestamp et de valeur indiqués ci-dessus. Permet de ne pas transmettre les timestamps et les valeurs sous forme de deux arguments distincts. Array(Tuple(T1, T2))
  • phi — Niveau de quantile, normalement compris dans la plage [0, 1] : soit un seul nombre pour l’ensemble de la grille, soit un tableau contenant un nombre par point de la grille. Doit être identique pour toutes les lignes. Float* ou UInt8/16/32/64 ou Int8/16/32/64 ou Array(Float*) ou Array(UInt8/16/32/64) ou Array(Int8/16/32/64)
Valeur renvoyée Renvoie le quantile phi des valeurs sur la grille spécifiée. Le tableau renvoyé contient une valeur pour chaque point de la grille temporelle. La valeur est NULL si aucun échantillon ne se trouve dans la fenêtre d’un point de grille donné. Array(Nullable(Float64)) Exemples
Dernière modification le 14 octobre 2026