[Feature] Phase 4: Grafana Dashboards

[GrammaTonic]

Phase 4: Grafana Dashboards

Timeline: Week 3-4 (2025-11-30 to 2025-12-10)
Status: Done
Goal: Create 4 pre-built Grafana dashboard JSON files for import into user's Grafana instance

Objectives

• Create Runner Overview dashboard (general status and health)
• Create DORA Metrics dashboard (deployment metrics)
• Create Performance Trends dashboard (build times, cache rates)
• Create Job Analysis dashboard (job details and failures)

Tasks (10 Total)

• TASK-037: Create monitoring/grafana/dashboards/runner-overview.json (12 panels, 3 rows: Runner Status, Runner Health, Quick Links)
• TASK-038: Configure dashboard variables: runner_name (multi-select), runner_type (multi-select) - applied to all 4 dashboards
• TASK-039: Create monitoring/grafana/dashboards/dora-metrics.json (12 panels: DF, Lead Time, CFR, MTTR, trends, DORA classification)
• TASK-040: Create monitoring/grafana/dashboards/performance-trends.json (14 panels: cache, CPU/memory, build percentiles, queue time)
• TASK-041: Create monitoring/grafana/dashboards/job-analysis.json (16 panels: summary, histogram, status, runner comparison)
• TASK-042: Add dashboard metadata: title, description, tags, version, refresh interval (15s)
• TASK-043: Test dashboards by importing into local Grafana instance with Prometheus datasource
• TASK-044: Capture screenshots of each dashboard for documentation - Deferred to [Backlog] TASK-044: Capture Grafana dashboard screenshots for documentation #1138
• TASK-045: Export final dashboard JSON files with templating variables configured + provisioning config added
• TASK-046: Validate all PromQL queries execute in <2 seconds with test data

Acceptance Criteria

• All 4 dashboards import successfully into Grafana v9+
• Dashboards display real-time data from Prometheus
• Variables filter panels correctly
• All PromQL queries execute in <2 seconds
• Screenshots included in documentation - Deferred to [Backlog] TASK-044: Capture Grafana dashboard screenshots for documentation #1138

Dashboard Inventory (Final)

Dashboard	File	UID	Panels	Refresh
Runner Overview	runner-overview.json	github-runner-runner-overview	12	15s
DORA Metrics	dora-metrics.json	github-runner-dora	12	30s
Performance Trends	performance-trends.json	github-runner-performance	14	15s
Job Analysis	job-analysis.json	github-runner-job-analysis	16	15s

Implementation PRs

• feat(monitoring): split mega-dashboard into 4 standalone Grafana dashboards #1137 (squash merged to develop)

Remaining

• TASK-044 screenshots tracked in [Backlog] TASK-044: Capture Grafana dashboard screenshots for documentation #1138 (backlog, low priority)

---

Part of: Prometheus Monitoring Implementation (v2.3.0)

[GrammaTonic]

All functional tasks complete (9/10). TASK-044 (screenshots) deferred to #1138 as it requires a live Grafana instance. All 4 dashboards are merged on develop via PR #1137.