Journaux et observabilité

formateur PromQLLire l’expression avant les données

Collez une requête pour l’analyse locale, puis passez aux exemples de labels ou à RE2 si nécessaire. Aucune série temporelle n’est interrogée.

formateur PromQL

Expression PromQL

Résultat

Traitement dans le navigateur, sans connexion à Prometheus ni envoi de requête.

Options

Saisissez une expression ou chargez un exemple.

Un graphique vide peut venir de la syntaxe, des labels ou des données absentes. formateur PromQL sépare ces causes : l’expression est-elle analysable, puis un sélecteur correspond-il à vos exemples ?

Le texte initial reste visible. Le formatage ne modifie que les espaces aux limites reconnues par l’analyseur PromQL ; comparez le résultat avant de réutiliser une alerte.

Pourquoi utiliser formateur PromQL

Trois vérifications distinctes, sans confondre analyse et exécution.

Vérifier les séries d’exemple une par une

formateur PromQL applique un sélecteur de vecteur pur aux métriques collées. Le filtre status=~"5.." retient 500 et 503, écarte 200 et ne prétend pas récupérer des séries réelles.

Un sélecteur retient deux métriques collées et en écarte une selon les labels status et job

Respecter les regex de Prometheus

Les labels sont testés avec RE2 sur la valeur entière, plutôt qu’avec une approximation JavaScript. formateur PromQL refuse les assertions avancées non prises en charge au lieu d’annoncer un faux succès.

Un motif RE2 ancré correspond à 500 entier mais pas à la seule sous-chaîne de 1500

Trois contrôles à enchaîner

L’analyse d’une requête et le filtrage d’exemples n’ont pas le même résultat.

01

Analyser d’abord la requête entière

Le mode PromQL signale la ligne et la colonne d’une accolade ou parenthèse manquante. Il ne propose pas une requête réparée à copier sans vérification.

02

Isoler ensuite un sélecteur

Saisissez par exemple http_requests_total{job="api"}, puis une métrique avec ses labels par ligne. Une valeur numérique finale ne sert pas au filtrage.

03

Tester le motif sur toute la valeur

Dans le mode RE2, saisissez une valeur par ligne. 5.. correspond à 500 mais pas à la sous-chaîne de 1500.

Ce que montrent les résultats locaux

Le texte, les labels d’exemple et les regex répondent à des questions séparées.

Syntaxe et arbre PromQL

La requête PromQL est analysée puis mise en forme avec prudence. L’arbre expose les imbrications ; une erreur ou un résultat périmé bloque l’export.

Sélecteur de labels sur exemples

Le sélecteur de labels PromQL combine =, !=, =~ et !~ pour chaque ligne. Un label absent vaut la chaîne vide et chaque non-correspondance indique son label.

Test RE2 ancré

Une regex PromQL utilise RE2. Les références arrière et assertions non compatibles sont rejetées ; chaque valeur est testée en entier.

Limites avant réutilisation

Une syntaxe correcte n’atteste ni la présence des métriques ni un résultat de requête.

Pas d’exécution sur des séries
formateur PromQL ne se connecte ni à une TSDB ni à l’API Prometheus. Il ne connaît pas les métriques réelles, leurs valeurs, leur nombre ou leur graphique dans votre environnement.
Exemples réservés aux sélecteurs
rate(), sum by, jointures et plages temporelles ne sont pas calculés sur des lignes collées. Une expression complète est uniquement analysée en mode PromQL.
Pas de réparation implicite
Une regex RE2 incorrecte ou une erreur syntaxique ne produit pas de texte « corrigé » exportable. Toute modification rend immédiatement l’ancien résultat périmé.

Questions sur formateur PromQL

Des réponses sur regex, regroupement et labels PromQL.

Comment fonctionne une regex PromQL ?

Le moteur RE2 compare le motif à la valeur entière du label. Dans formateur PromQL, 5.. correspond à 500, alors que 1500 ne passe pas.

Puis-je utiliser PromQL group by sur ces exemples ?

L’analyseur montre la structure d’un groupement, mais le calcul exige des séries temporelles. Les exemples n’acceptent qu’un sélecteur pur.

Que vérifie PromQL label_replace ici ?

La syntaxe de l’appel peut être analysée. La fonction n’est pas exécutée et les labels des exemples ne sont jamais réécrits.

PromQL sum by renvoie-t-il un résultat ici ?

Non. Le mode PromQL peut afficher l’expression et son arbre, mais aucun total groupé n’est produit sans données Prometheus.

Où trouver un tutoriel PromQL pour les sélecteurs ?

Essayez l’exemple de sélecteur pour voir les quatre opérateurs sur des labels collés. Pour la sémantique complète du langage, consultez la documentation Prometheus.

Un cas PromQL manque à l’appel ?

Essayer formateur PromQL

formateur PromQL permet d’examiner syntaxe, exemples de sélection et regex RE2 avant de placer la requête dans une alerte ou un tableau de bord.

Une nouvelle saisie désactive l’export précédent jusqu’à la fin du contrôle actuel.