Skip to main content
Évalue une requête Prometheus à l’aide des données d’une table TimeSeries sur une plage d’instants d’évaluation.

Syntaxe

Arguments

  • db_name - Le nom de la base de données où se trouve une table TimeSeries.
  • time_series_table - Le nom d’une table TimeSeries.
  • promql_query - Une requête écrite en syntaxe PromQL.
  • start_time - L’heure de début de la plage d’évaluation.
  • end_time - L’heure de fin de la plage d’évaluation.
  • step - Le pas utilisé pour faire progresser le temps d’évaluation de start_time à end_time (bornes incluses).

Valeur renvoyée

La fonction peut renvoyer différentes colonnes selon le type de résultat de la requête transmise au paramètre promql_query :

Fonctionnalités PromQL prises en charge

Sélecteurs

Sélecteurs instantanés, sélecteurs de plage, correspondances de labels (=, !=, =~, !~), modificateurs offset, modificateurs d’horodatage @ et sous-requêtes.

Fonctions

Remarque : histogram_quantile utilise une interpolation linéaire sur les buckets d’histogrammes classiques (identifiés par le label le). Les histogrammes natifs ne sont pas pris en charge. L’argument phi (niveau de quantile) doit être un scalaire constant. Les expressions qui varient à chaque pas, comme histogram_quantile(time() / 1000, ...), sont rejetées avec une exception NOT_IMPLEMENTED.

Opérateurs

Opérateurs binaires arithmétiques (+, -, *, /, %, ^, atan2) et de comparaison (==, !=, <, >, <=, >= avec bool en option), avec les modificateurs on()/ignoring() et group_left()/group_right(). Opérateurs d’ensemble logiques and, or et unless, avec les modificateurs on()/ignoring(). Les opérateurs unaires + et -.

Opérateurs d’agrégation

sum, avg, min, max, count, stddev, stdvar, group, quantile, topk, bottomk, limitk — avec les modificateurs facultatifs by() ou without().

Pas encore pris en charge

  • Opérateur d’agrégation count_values
  • Fonctions de plage predict_linear, avg_over_time, min_over_time, max_over_time, sum_over_time, count_over_time, quantile_over_time, stddev_over_time, stdvar_over_time, present_over_time, absent_over_time, mad_over_time, first_over_time, ts_of_min_over_time, ts_of_max_over_time, ts_of_last_over_time, ts_of_first_over_time
  • Fonction absent

Exemple

Dernière modification le 18 août 2026