01
Zuerst die Abfrage parsen
Im PromQL-Modus Klammern und verschachtelte Funktionen prüfen. Fehler werden mit Zeile und Spalte angezeigt; ein geratenes Reparaturergebnis lässt sich nicht exportieren.
Logs und Observability
PromQL-FormatterErst den Ausdruck, dann die Daten prüfen
PromQL-Ausdruck einfügen oder zum Selektor- und RE2-Test wechseln. Diese Seite führt keine Zeitreihenabfrage aus.
PromQL-Formatter
Die Verarbeitung erfolgt im Browser; keine Verbindung zu Prometheus und kein Upload der Abfrage.
Ausdruck eingeben oder Beispiel laden.
Ein leeres Dashboard kann an Klammern, Labelwerten oder fehlenden Daten liegen. Der PromQL-Formatter trennt die Syntaxprüfung von der Frage, ob ein Vektorselektor auf Ihre eigenen Beispiele passt.
Der ursprüngliche Ausdruck bleibt stehen. Die Formatierung ändert nur Abstände an erkannten PromQL-Grenzen, damit Sie den Text vor dem Einsatz in einer Alert-Regel vergleichen können.
Warum den PromQL-Formatter verwenden
Syntax, lokale Label-Beispiele und Regex liefern drei unterschiedliche Antworten.
Selektor auf Beispiele anwenden
Der PromQL-Formatter prüft einen reinen Vektorselektor Zeile für Zeile an eingefügten Metriken. status=~"5.." erfasst 500 und 503, aber nicht 200; echte Serien werden dabei nicht geladen.
RE2 statt JavaScript-Näherung
Label-Regex wird mit RE2 und vollständigem Wertabgleich geprüft. Der PromQL-Formatter weist nicht unterstützte Lookarounds zurück, statt einen falschen Treffer zu melden.
In drei Schritten zum klaren Befund
Ein vollständiger Ausdruck und ein Selektor für Beispiele sind getrennte Aufgaben.
02
Danach den Selektor isolieren
Für Beispiele nur einen Selektor wie http_requests_total{job="api"} eingeben. Pro Zeile eine Metrik mit Labels einfügen; ein Zahlenwert am Ende wird nicht berechnet.
03
Regex am ganzen Wert testen
Im RE2-Modus Muster und je einen Wert pro Zeile eingeben. 5.. trifft 500, aber nicht den Teilstring in 1500.
Was die lokale Prüfung zeigt
Die drei Ansichten unterscheiden Textstruktur von Labelabgleich.
PromQL Syntax und Struktur
Die PromQL-Abfrage wird geparst und konservativ formatiert. Eine Strukturansicht macht verschachtelte Teile sichtbar; Fehler sperren den Export.
Label-Matcher gegen Beispiele
Der PromQL Label-Matcher kombiniert =, !=, =~ und !~. Fehlende Labels gelten als leere Zeichenfolge; nicht passende Labels stehen in der Ergebniszeile.
RE2 mit voller Übereinstimmung
PromQL Regex nutzt RE2. Rückverweise und Lookaround werden abgewiesen, und jeder angegebene Wert wird als Ganzes getestet.
Grenzen vor dem Kopieren
Ein korrekt geparster Text belegt keine erfolgreichen Abfragen im Zielsystem.
- Keine echte Zeitreihenabfrage
- Der PromQL-Formatter verbindet sich weder mit einer TSDB noch mit einer Prometheus API. Er kennt keine vorhandenen Metriken, Messwerte, Serienzahlen oder Grafiken Ihrer Instanz.
- Nur reine Selektoren für Beispiele
- rate(), sum by, Joins und Bereichsabfragen werden nicht auf Beispielzeilen berechnet. Vollständige Ausdrücke lassen sich nur auf Syntax und Struktur prüfen.
- Kein stiller Regex-Ersatz
- Ungültige RE2-Muster bleiben Fehler. Nach einer Änderung ist das bisherige Ergebnis veraltet; Kopieren und Herunterladen bleiben bis zur erneuten Prüfung gesperrt.
Häufige Fragen zum PromQL-Formatter
Antworten zu PromQL Regex, Gruppierung und Labeln.
Wie kann ich PromQL Regex für Labels testen?
Im RE2-Modus ein Muster und Werte zeilenweise eingeben. PromQL-Formatter prüft die vollständige Übereinstimmung wie ein Prometheus-Label-Matcher; Teilstrings allein zählen nicht.
Kann ich PromQL sum by hier ausführen?
Die Syntax und Struktur einer sum by-Abfrage werden angezeigt. Für die Berechnung gruppierter Messwerte wird aber eine echte Zeitreihendatenbank benötigt.
Wie funktioniert PromQL group by mit den Beispielen?
Die Beispiele sind nur für reine Vektorselektoren gedacht. Eine Gruppierung kann hier nicht ausgewertet werden; dafür müssten Zeitreihenwerte vorliegen.
Prüft das Tool PromQL label_replace?
Die Funktion kann als Text Teil der geparsten Abfrage sein. PromQL-Formatter verändert damit keine Beispiel-Labels und führt die Funktion nicht auf Daten aus.
Kann ein PromQL or Ausdruck Serien zusammenführen?
Das Zusammenführen erfordert Query-Auswertung auf einem Server. Diese Seite prüft die Form des Ausdrucks, nicht dessen berechnete Serien.
Einen PromQL-Grenzfall entdeckt?
Den PromQL-Formatter jetzt ausprobieren
Der PromQL-Formatter zeigt Syntax, lokale Selektorbeispiele und echte RE2-Prüfung, bevor ein Ausdruck in einem Dashboard oder Alert landet.
Ändert sich die Eingabe, wird der alte Export sofort gesperrt. Nutzen Sie erst das Ergebnis der aktuellen Prüfung.