Versioned observability configuration for production deployments. Alert rules, dashboards, and SLO definitions are validated in CI.
| Path | Purpose |
|---|---|
| slo-definitions.md | SLI/SLO targets and error budget policy |
| alertmanager.yml | Alert routing and escalation config |
| alerts/ | Prometheus alert rule files |
| dashboards/ | Grafana dashboard JSON models |
All alerts link to docs/security/INCIDENT_RESPONSE.md. Use that playbook for triage, communication, and recovery.
docker compose -f docker-compose.monitoring.yml up -d
# Grafana: http://localhost:3000 (admin / admin)
# Prometheus: http://localhost:9090
# Alertmanager: http://localhost:9093PRs touching docs/ops/ or services/prometheus.yml run:
promtool check ruleson all alert filesamtool check-configon alertmanager config- JSON schema validation on Grafana dashboards
- Verification that alerts include a runbook link and the incident response doc exists