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.
No data is transmitted — everything runs locallyTool
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