pint

Lint Prometheus rules

$ pint lint [rules.yaml]

$ pint -c [config.yaml] lint [rules.yaml]

$ pint watch [rules/]

$ pint lint --output=json [rules.yaml]

$ pint ci

$ pint checks

pint [-c config] command [options] [files]

pint validates Prometheus alerting and recording rules. It catches errors before deployment.
Syntax checking validates PromQL queries. Invalid queries won't load in Prometheus.
Live checking queries actual Prometheus. This verifies metrics exist and selectors match.
Template validation catches annotation and label errors. Alert messages are verified.
Watch mode monitors rule files. Changes trigger immediate re-checking.

lint

Check rules for problems.

Watch and lint continuously.

CI/CD mode.

List available checks.

Configuration file.

Output format.

Disable colors.

Verbose output.

promql/syntax - Query syntax
promql/series - Series existence
alerts/for - Alert duration
alerts/template - Template errors
rule/duplicate - Duplicate rules

Live checks need Prometheus access. Some checks have false positives. Configuration complexity.

pint was created by Cloudflare for validating their Prometheus rules at scale. It provides deeper analysis than Prometheus's built-in rule checking.

promtool(1), prometheus(1), amtool(1)