Why it matters
PromQL is compact, which makes it hard to read: sum by (route) (rate(http_requests_total[5m])) packs four ideas into one line, and the order matters.
This explainer names each part and what it does, and catches the classic mistakes before you put a query on a dashboard or an alert. It is a documented subset, not a full parser.
How to use it
- Type or paste your input; the example shows the format.
- Press Explain. Results also update as you type.
- Read the summary line, then the table, notes or output below it.
- Copy or download what you need. Nothing leaves this page.
FAQ
What is the difference between rate and irate?
rate averages over the whole range, so it is smooth and right for alerts. irate uses only the last two samples, so it reacts fast but is spiky.
Is my input uploaded?
No. The tool runs in your browser and nothing you type, paste or open is sent anywhere.
Can I rely on the result?
It follows the public specification or formula named on this page and says where it simplifies. Check anything critical against the official tool or documentation before you ship it.