{"repo":"cbrgm/promcheck","free":true,"listed":false,"github":"https://github.com/cbrgm/promcheck","clone":"git clone https://github.com/cbrgm/promcheck.git","description":"A tool and exporter to identify faulty Prometheus rules","language":"Go","stars":95,"topics":["prometheus","rules","recording","alert","alerting","monitoring","ilovetags","metrics","exporter"],"license":"Apache-2.0","category":"analytics","readme_excerpt":"promcheck ✔️ A tool to identify faulty Prometheus rules About promcheck enables you to identify recording or alerting rules using missing metrics or wrong label matchers (e.g. because of exporter changes or human-errors). promcheck validates Prometheus vector selectors and checks if they return a result value or not. As a basis for validation, promcheck uses Prometheus rule files, but it can also query rules directly from a running Prometheus instance. It scans the PromQL expression of each recording and alerting rule, takes the individual referenced selectors out of it and probes them against a remote Prometheus instance. Overview About Installation Basic Usage + Use-Cases + Validate rules from a running Prometheus instance + Validate rules from existing rule files + Validate rules from inline PromQL queries + Prometheus Exporter Configuration + Usage Information + CI/CD Usage - Exit codes + Output Formats Container Usage Kubernetes Deployment Metrics Examples - Validating multiple rule groups Contributing & License Installation promcheck is available on Linux, OSX and Windows platforms. Binaries for Linux, Windows and Mac are available as tarballs in the release page. You may also build promcheck from source (using Go 1.25+). In order to build promcheck from source you must: Clone this repository Run make build Basic Usage promcheck can be used in three different modes: Validate rules passed to promcheck as parameters ( --check.query ) Validate rules from existing rule file","default_branch":null,"files":null,"tree":[],"storefront":"/r/cbrgm","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/cbrgm/promcheck/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}