Formatteur et validateur de requêtes PromQL

Formater et valider instantanément des requêtes Prometheus PromQL

Le formatateur et validateur de requêtes PromQL nettoie les requêtes que vous écrivez contre Prometheus et d'autres bases de données compatibles avec les séries temporelles. Collez une expression métrique et l'outil normalise l'espace autour des opérateurs binaires, organise les agrégations, les appels de fonction et les matcheurs de labels sur des lignes séparées lorsque la requête devient longue, et identifie les parenthèses déséquilibrées, les accolades mal correspondantes, les durées manquantes et d'autres problèmes syntaxiques avant même que vous n'aiez collé la requête dans un tableau de bord ou une règle d'alerte. Tout cela fonctionne localement dans votre navigateur, donc les requêtes — qui exposent souvent des noms internes de métriques et des étiquettes — ne quittent jamais votre appareil.

Comment utiliser

1. Collez votre requête PromQL dans la zone d'entrée, ou téléchargez un .promql ou fichier texte à l'aide du sélecteur de fichier.
2. Choisissez la largeur d'indentation — 2 espaces, 4 espaces ou un caractère de tabulation littéral — pour toute expansion sur plusieurs lignes.
3. Définissez la longueur maximale d'une ligne. Les appels de fonction, les ensembles de matcheurs de labels et les opérateurs booléens à faible priorité (and, or, unless) sont placés sur des lignes séparées une fois que la ligne formatée dépasserait cette largeur.
4. Basculer Toujours séparer si vous souhaitez que chaque agrégation, chaque liste d'arguments d'appel de fonction et chaque ensemble de matcheurs de labels soit sur une ligne séparée, indépendamment de la longueur.
5. Basculer Formater comme règle de enregistrement et fournir un nom de métrique (par exemple job:http_errors:rate5m) pour émettre la requête formatée comme une règle de enregistrement prête à être collée sous forme de YAML Prometheus.
6. Copiez le résultat formaté ou téléchargez-le sous forme de .promql fichier.

Caractéristiques

• Sensibilité à l'espace PromQL – Insère un espace unique autour des opérateurs arithmétiques, de comparaison et booléens tout en maintenant les matcheurs de labels serrés à l'intérieur { } des accolades.
• Disposition intelligente sur plusieurs lignes – Interrompt les requêtes longues à and / or / unless d'abord, puis aux limites des arguments de fonction, puis aux matcheurs individuels de labels afin que le résultat reste facile à scanner.
• Soutien des agrégations et des matcheurs de vecteurs – Reconnaît sum, avg, topk, quantile et amis avec by, without, on, ignoring, group_left et group_right modificateurs.
• Tokeniseur de durée et de sous-requête – Analyse des intervalles composés comme 1h30m et des sous-requêtes comme [5m:1m] comme des unités uniques afin qu'elles ne soient jamais coupées au milieu d'un mot.
• Validation de syntaxe – Détecte les parenthèses, crochets et accolades déséquilibrées, les ouvriers et fermiers mal correspondants, les corps de matcheurs de labels invalides, les intervalles de sous-index invalides et les chaînes non terminées, chacun signalé avec un numéro de ligne.
• Exportation de règle de enregistrement – Optionnellement, formate la requête formatée comme un bloc de règle de enregistrement Prometheus en YAML, en utilisant un scalaire de bloc YAML pour les expressions multi-lignes afin que l'indentation soit conservée.

Cas d'utilisation courants

• Nettoyer des requêtes PromQL copiées à la main des éditeurs de panneaux Grafana avant de les intégrer dans des tableaux de bord ou des règles d'alerte.
• Préparer des expressions PromQL pour une revue de code — des requêtes longues sur les taux d'erreur ou la saturation deviennent des différences lisibles une fois que chaque branche est sur sa propre ligne.
• Détecter des erreurs syntaxiques subtiles (durée manquante, virgule inattendue, fermeture manquante { après modification des matcheurs de labels) sans passer par une instance de Prometheus en temps réel.
• Convertir des requêtes brutes en YAML de règle de enregistrement Prometheus pour des pipelines de pré-agrégation.
• Apprendre PromQL — la sortie normalisée rend les priorités des opérateurs et les groupements d'agrégation immédiatement visibles pour les lecteurs apprenant la langue.