alert-rule-testing

Community

Rigorous promtool rule testing for alerts.

Authorririnto
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prometheus alert rules are validated through deterministic promtool tests, preventing regressions by ensuring correct alert lifecycles and reliable query results.

Core Features & Use Cases

  • Write promtool test rules to exercise alert lifecycles (pending, firing, and resolved) and protect against regressions.
  • Design input_series fixtures and test cases to simulate realistic traffic, edge cases (missing, stale samples, counter resets), and verify rule behavior.
  • Validate both alert state transitions and intermediate PromQL results with dedicated tests (alert_rule_test and promql_expr_test), ensuring test stability across rule changes.

Quick Start

Create a minimal promtool test file for an alert rule and run it with promtool test rules.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: alert-rule-testing
Download link: https://github.com/ririnto/sinon/archive/main.zip#alert-rule-testing

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.