Measure DORA metrics

Why measure DORA

DORA metrics—deployment frequency, lead time for changes, change failure rate, and mean time to restore—provide a shared language for delivery performance. Instrumenting them accurately enables leadership to focus improvement efforts and celebrate real progress.

Foundational requirements

• Source control with meaningful commit metadata and standardized branching.
• CI/CD tooling capable of emitting deploy events with timestamps and status.
• Incident management system or ticketing workflow that captures start/end times.
• Agreement on what qualifies as a production deployment and service boundaries.

Core plays

1. Map the value stream. Document commit, build, deploy, and release milestones for each service. Capture manual steps and systems involved.
2. Collect raw events automatically. Use webhooks, APIs, or data pipelines to ingest commits, pipeline runs, deploy events, and incident records into a central store.
3. Normalize identifiers. Ensure commits, deployments, and incidents share common keys (service name, environment, change ID) so metrics align across systems.
4. Automate calculations. Build repeatable transformations (SQL, dbt, notebooks) that compute each metric with filters per team, service, and environment.
5. Publish and review. Create dashboards with trendlines, targets, and annotation fields for experiments. Establish review cadences where leaders turn insights into actions.

Operating cadence

• Nightly or near-real-time metric refresh depending on data availability.
• Weekly engineering review to inspect trends, discuss anomalies, and assign improvement experiments.
• Quarterly retrospective on metric quality, definitions, and adoption to avoid metric drift.

Signals you are succeeding

• All four metrics update automatically without manual spreadsheets.
• Teams reference the shared dashboard in retros, planning, and leadership reviews.
• Improvement backlog links directly to metric trends, showing cause and effect.

Supporting assets

• DORA instrumentation checklist to guide setup.
• FAQ to answer stakeholder questions about data quality, scope, and governance.
• Reference material: manual/01-dora-accelerate/index.md.