Project Health Dashboard

Project Health Dashboard helps the Tech Lead track project health as both a product and a repository. This is separate from runtime/DBA observability: it analyzes trains, risks, tech debt, LOC, and quality gates.

What to Use It For

• Quickly understand which train is active and which was closed most recently.
• See problem areas: active Red/Amber risks and open High/Critical debt.
• Find the largest files (top-10 LOC) and src_loc_guard risk.
• Check quality gate status from evidence without manually walking logs.
• Assess architectural discipline through invariant signals.

Data Source

Metrics are generated by the script:

python3 tools/observability/export_metrics.py --format prometheus --out artifacts/tmp/project_health.prom

Key sources:

• PROJECT_STATUS.md

• latest gate artifacts in docs/planning/evidence/release_trains/<RM-ID>/ (if present)

Metrics and Meaning

• angara_project_release_health — release context (active/closed/planning).
• angara_project_active_risks — number of active risks.
• angara_project_tech_debt_by_component — debt by component/severity.
• angara_project_top_loc_files — top LOC + threshold markers.
• angara_project_gate_status — PASS/FAIL/unknown quality gates.
• angara_project_architecture_health — invariants total + missing links.

Grafana dashboard

• Title: AngaraBase Project Health
• UID: angarabase-project-health-v0
• Path: tools/observability/grafana/angarabase-project-health.json

The dashboard intentionally does not include runtime panels (QueryStore/pgwire/io_uring/WAL runtime): this is the project governance level.