Files:
docs/operations.md:104-110 (§Dashboards)
infra/dashboards/ (directory, empty)
Issue
operations.md §Dashboards states:
Committed as code under infra/dashboards/:
overview.json
cloud.json
auth.json
business.json
The directory exists but is empty.
Impact
During an incident, the responder follows the ops doc, runs ls infra/dashboards/, finds nothing, loses firefighting minutes figuring out that Prometheus metrics exist but no ready-made dashboards do.
Fix
Two paths:
(a) Commit the four JSON dashboards — export from Grafana as JSON model, stamp into infra/dashboards/. Then document the re-import flow.
(b) Delete the §Dashboards section of operations.md. Users can build dashboards ad-hoc against the documented metrics.
(a) is clearly better long-term (incident response benefits from curated views) but (b) is faster and stops the live lie.
Related
- Related: HIGH-D3 (rollout-health.yml referenced, doesn't exist) — same kind of drift
- Audit doc:
docs/reviews/Audit_2026-04-23.md (HIGH-D4)
Files:
docs/operations.md:104-110(§Dashboards)infra/dashboards/(directory, empty)Issue
operations.md§Dashboards states:The directory exists but is empty.
Impact
During an incident, the responder follows the ops doc, runs
ls infra/dashboards/, finds nothing, loses firefighting minutes figuring out that Prometheus metrics exist but no ready-made dashboards do.Fix
Two paths:
(a) Commit the four JSON dashboards — export from Grafana as JSON model, stamp into
infra/dashboards/. Then document the re-import flow.(b) Delete the §Dashboards section of operations.md. Users can build dashboards ad-hoc against the documented metrics.
(a) is clearly better long-term (incident response benefits from curated views) but (b) is faster and stops the live lie.
Related
docs/reviews/Audit_2026-04-23.md(HIGH-D4)