Observability & SRE
PromQL Validator
Enter a PromQL expression to validate syntax, label matcher usage, aggregation operators, and range vector requirements. Runs entirely in your browser — no Prometheus connection needed.
Calculations run locally in your browserTool
About this tool
PromQL Validator
The PromQL Validator checks PromQL query syntax including label matchers, aggregation operators, range vectors, and subquery notation without requiring a Prometheus connection.
• Validate a PromQL alert rule before deploying to avoid silent failures
• Debug a PromQL syntax error without a live Prometheus instance
• Check rate() range vector duration against your scrape interval
• Validate aggregation by() and without() label sets
Affiliate disclosure
Uptime, incident, and on-call management. Better Stack provides status pages, incident management, and on-call scheduling for engineering teams.
View options with Better Stack
External site · Independent provider · We may receive a commission · Not a recommendation
FAQ
What does this tool tell you?
The PromQL Validator checks PromQL query syntax including label matchers, aggregation operators, range vectors, and subquery notation without requiring a Prometheus connection.
What affects the result most?
Validates PromQL query syntax for metric selectors, label matchers, and aggregation operators. Detects common errors: unclosed braces, invalid label matcher operators, missing metric names. Aggregation validation: sum, avg, min, max, count, topk, bottomk, quantile — correct by() and without() usage.
How should I use the result?
Treat the tool's output as a first-pass check, not a proof of correctness. A clean pass means no issues in the patterns this tool recognizes; a failure points to a specific problem you can investigate in your source. The underlying spec is the authoritative source for edge cases.
Related tools