Verstehen Sie jede PromQL-Abfrage.

Der PromQL Explainer ist ein kostenloses, browserbasiertes Tool, das eine Prometheus-PromQL-Abfrage entgegennimmt und in eine verständliche Erklärung in Klartext aufschlüsselt. Es geht jeden Teil des Ausdrucks durch — den Metrik-Selektor und seine Label-Matcher, jeden Bereich oder Offset, die umschließende Rate oder Aggregation sowie den abschließenden Schwellenwertvergleich — damit Sie lesen können, was eine Abfrage tatsächlich tut, ohne sie im Kopf zu zerlegen.

Nein. Der Explainer läuft zu 100 % clientseitig. Ihre Abfrage wird in Ihrem Browser-Tab geparst und erklärt — nichts wird auf einen Server hochgeladen, und es gibt kein Konto und keine Anmeldung. Sie können bedenkenlos Abfragen einfügen, die interne Metrik- oder Label-Namen referenzieren.

Der Explainer deckt die Muster ab, denen Sie in Alarmierung und Dashboards am häufigsten begegnen: Instant- und Range-Vektor-Selektoren mit Label-Matchern (=, !=, =~, !~), Bereichsdauern und Offsets, rate / irate / increase, die Aggregationsoperatoren (sum, avg, max, min, count und Verwandte) mit by / without zur Gruppierung, gängige Funktionen wie histogram_quantile und clamp sowie binäre Vergleiche gegen einen Schwellenwert. Exotische oder tief verschachtelte Subqueries werden möglicherweise zusammengefasst statt vollständig zerlegt.

Prometheus nennt Ihnen das Ergebnis einer Abfrage; der Explainer nennt Ihnen ihre Bedeutung. Er verbindet sich nicht mit einem Prometheus-Server und liefert keine Zeitreihendaten zurück — er liest den Ausdruck selbst und beschreibt die Absicht. Das macht ihn nützlich, um die Alarmregel einer Kollegin oder eines Kollegen zu überprüfen, PromQL zu lernen oder eine Abfrage vor dem Ausliefern auf Plausibilität zu prüfen.

Ja. Da jede Klausel benannt und beschrieben wird, dient der Explainer zugleich als Lernhilfe: Fügen Sie ein Beispiel aus einem Runbook oder Dashboard ein und lesen Sie genau zurück, aus welchem Selektor, Bereich, welcher Aggregation und welchem Vergleich es aufgebaut ist. Kombinieren Sie es mit der offiziellen Prometheus-Dokumentation zum Querying für die formale Grammatik.

Nein. Es handelt sich um ein unabhängiges Community-Tool, das nicht mit dem Prometheus-Projekt oder der Cloud Native Computing Foundation verbunden oder von diesen unterstützt wird. Prometheus ist eine Marke der Linux Foundation. Das Tool bildet die PromQL-Syntax zur Vertrautheit nach und verwendet den Herstellernamen nur, um zu beschreiben, was es erklärt.

rate() berechnet die durchschnittliche Zunahmerate eines Counters pro Sekunde über das Bereichsfenster — zum Beispiel mittelt rate(http_requests_total[5m]) die Zunahme pro Sekunde über die vollen fünf Minuten. Es glättet Spitzen und ist die Standardwahl für Counter-Metriken und Alarmregeln. Der Explainer erkennt rate() und benennt die Bereichsdauer, sodass Sie das Fenster auf einen Blick ablesen können.

rate() mittelt die Zunahme pro Sekunde über den gesamten Range-Vektor und erzeugt stabile Werte, die sich für Alarme und sich langsam ändernde Counter eignen. irate() verwendet nur die letzten beiden Samples im Fenster, was es reaktionsfreudiger, aber verrauschter macht — am besten für das Plotten sich schnell ändernder Counter geeignet, bei denen Sie kurze Spitzen sehen möchten. Der Explainer kennzeichnet, welches der beiden in Ihrer Abfrage vorkommt, und beschreibt sein Verhalten.

Eckige Klammern mit einer Dauer definieren einen Range-Vektor — sie weisen PromQL an, alle Samples für jede übereinstimmende Zeitreihe über dieses Rückblickfenster zurückzugeben. [5m] steht für die letzten fünf Minuten an Daten. Funktionen wie rate(), increase() und avg_over_time() benötigen einen Range-Vektor als Eingabe, daher sind es die Klammern, die diese Funktionen erst funktionieren lassen.

Geschweifte Klammern enthalten eine durch Kommas getrennte Liste von Label-Matchern, die filtern, welche Zeitreihen ausgewählt werden. Der Operator = trifft auf einen exakten Wert zu, != schließt ihn aus, =~ trifft per regulärem Ausdruck zu und !~ schließt per regulärem Ausdruck aus. So wählt {job="api", status!="200"} Zeitreihen aus dem Job api aus und lässt dabei alle mit einem HTTP-200-Status weg. Der Explainer benennt jeden Matcher und seinen Operator in verständlichem Klartext.