Comprenez n’importe quelle requête PromQL.

Le PromQL Explainer est un outil gratuit, exécuté dans le navigateur, qui prend une requête PromQL de Prometheus et la décompose en une explication en langage clair. Il parcourt chaque partie de l’expression — le sélecteur de métrique et ses filtres d’étiquettes, toute plage ou tout décalage, le rate ou l’agrégation qui l’enveloppe, et la comparaison de seuil à la fin — afin que vous puissiez lire ce qu’une requête fait réellement sans avoir à l’analyser de tête.

Non. L’explorateur fonctionne à 100 % côté client. Votre requête est analysée et expliquée à l’intérieur de votre onglet de navigateur — rien n’est envoyé à un serveur, et il n’y a ni compte ni inscription. Vous pouvez coller en toute sécurité des requêtes qui font référence à des noms de métriques ou d’étiquettes internes.

L’explorateur couvre les motifs que vous rencontrez le plus souvent dans les alertes et les tableaux de bord : les sélecteurs de vecteurs instantanés et de plage avec filtres d’étiquettes (=, !=, =~, !~), les durées de plage et les décalages, rate / irate / increase, les opérateurs d’agrégation (sum, avg, max, min, count et leurs semblables) avec regroupement by / without, des fonctions courantes comme histogram_quantile et clamp, et les comparaisons binaires par rapport à un seuil. Les sous-requêtes exotiques ou profondément imbriquées peuvent être résumées plutôt que entièrement décomposées.

Prometheus vous indique le résultat d’une requête ; l’explorateur vous en indique la signification. Il ne se connecte pas à un serveur Prometheus et ne renvoie aucune donnée de séries temporelles — il lit l’expression elle-même et en décrit l’intention. Cela le rend utile pour relire la règle d’alerte d’un collègue, apprendre PromQL ou vérifier la cohérence d’une requête avant de la livrer.

Oui. Comme chaque clause est nommée et décrite, l’explorateur fait aussi office de support pédagogique : collez un exemple tiré d’un runbook ou d’un tableau de bord et lisez exactement de quel sélecteur, de quelle plage, de quelle agrégation et de quelle comparaison il est constitué. Associez-le à la documentation officielle de requêtage de Prometheus pour la grammaire formelle.

Non. C’est un outil communautaire indépendant qui n’est ni affilié au projet Prometheus ou à la Cloud Native Computing Foundation, ni approuvé par eux. Prometheus est une marque de The Linux Foundation. L’outil reproduit la syntaxe PromQL par souci de familiarité et n’utilise le nom du fournisseur que pour décrire ce qu’il explique.

rate() calcule le taux d’augmentation moyen par seconde d’un compteur sur la fenêtre de plage — par exemple, rate(http_requests_total[5m]) fait la moyenne de l’augmentation par seconde sur l’ensemble des cinq minutes. Elle lisse les pics et constitue le choix standard pour les métriques de type compteur et les règles d’alerte. L’explorateur identifie rate() et nomme la durée de plage afin que vous puissiez lire la fenêtre d’un coup d’œil.

rate() fait la moyenne de l’augmentation par seconde sur l’ensemble du vecteur de plage, produisant des valeurs stables qui conviennent aux alertes et aux compteurs à évolution lente. irate() n’utilise que les deux derniers échantillons de la fenêtre, ce qui le rend plus réactif mais plus bruité — à réserver de préférence à la représentation graphique de compteurs à évolution rapide où l’on veut voir les pics brefs. L’explorateur étiquette celui qui apparaît dans votre requête et décrit son comportement.

Des crochets contenant une durée définissent un vecteur de plage — ils indiquent à PromQL de renvoyer tous les échantillons de chaque série correspondante sur cette fenêtre de recul. [5m] désigne les cinq dernières minutes de données. Des fonctions telles que rate(), increase() et avg_over_time() exigent un vecteur de plage en entrée ; ce sont donc les crochets qui font fonctionner ces fonctions.

Les accolades contiennent une liste de filtres d’étiquettes séparés par des virgules qui déterminent quelles séries temporelles sont sélectionnées. L’opérateur = correspond à une valeur exacte, != l’exclut, =~ correspond par expression régulière, et !~ exclut par expression régulière. Ainsi, {job="api", status!="200"} sélectionne les séries du job api tout en écartant celles dont le statut HTTP est 200. L’explorateur nomme chaque filtre et son opérateur en langage clair.