Start a project

Tool 297 of 425 · Observability

PromQL Explainer

Breaks a PromQL expression into parts with a plain-English meaning for each, and flags common mistakes such as rate() without a range.

PromQL Explainer

Your input

Result

PartMeaning

    01

    What it does

    Breaks a PromQL expression into parts with a plain-English meaning for each, and flags common mistakes such as rate() without a range.

    • Selectors, label matchers and range vectors
    • 30 functions and 11 aggregations explained
    • by and without grouping
    • Mistakes: rate of a sum, missing le, counters without rate

    02

    Private by design

    Everything happens in your browser. Nothing you type, paste or upload is sent anywhere, and it keeps working offline once the page has loaded.

    03

    What you get

    A part-by-part explanation, with a Copy and a Download button on every result.

    • PromQL
    • Prometheus
    • Grafana

    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

    1. Type or paste your input; the example shows the format.
    2. Press Explain. Results also update as you type.
    3. Read the summary line, then the table, notes or output below it.
    4. 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.

    Work with me

    Want a site that gets these right?

    I build fast, accessible websites and web apps that pass these checks from day one. Tell me about your project and I'll reply personally with honest next steps.

    All developer tools · Back to leej.uk