Skip to content

[P1] infra/dashboards/ is empty but operations.md claims four committed JSONs #72

@audriB

Description

@audriB

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)

Metadata

Metadata

Assignees

No one assigned

    Labels

    P1-highHigh priority — fix this weekaudit-2026-04-23Finding from 2026-04-23 auditdocumentationImprovements or additions to documentation

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions