How grafana/promql-anomaly-detection works
This repository is a PromQL anomaly-detection framework, primarily implemented as Prometheus recording and alerting rules. Users tag metrics with anomaly labels, configure Prometheus to load the rules, and use the resulting anomaly bands and alerts; Grafana dashboards provide visualization. The README documents adaptive and robust strategies and a demo stack. Source excerpts were unavailable, so relationships below are limited to those explicitly described in the README.
Main entry points: docker-compose.yml Demo services · grafana Grafana · adaptive.yml Adaptive bands · robust.yml Robust bands
Components 16
Detection rules
- Rule configuration
rules - Adaptive bands
rules/adaptive.yml - Robust bands
rules/robust.yml - Metric selection examples
rules/examples - Extra rules
rules/extra - Band crossing alerts
rules
Demo and visualization
- Demo Prometheus config
demo/src/prometheus/prometheus-config.yaml - Grafana
demo/src/grafana - Anomaly dashboards
demo/src/grafana/provisioning/dashboards/anomalies - Demo services
demo/docker-compose.yml - OTel Collector config
demo/src/otelcollector/otelcol-config.yml - Frontend proxy
demo/src/frontendproxy/envoy.tmpl.yaml
Other components
- Metric operator
- Tagged metrics
- Prometheus
- Dashboard user
Connections 12
- Metric operator → Tagged metrics: tags for detection
README.md - Tagged metrics → Prometheus: provides time series
README.md - Prometheus → Rule configuration: loads configured rules
README.md - Adaptive bands → Prometheus: generates bands
README.md - Robust bands → Prometheus: generates bands
README.md - Metric selection examples → Metric operator: guides metric selection
README.md - Prometheus → Band crossing alerts: detects band crossings
README.md - Demo services → Demo Prometheus config: starts demo services
README.md - Demo services → Grafana: starts demo services
README.md - Demo services → OTel Collector config: starts demo services
README.md - Grafana → Anomaly dashboards: displays anomalies
README.md - Dashboard user → Grafana: views dashboards
README.md