GitBiased journal
How to use DORA metrics without creating more noise
A practical guide to reading delivery frequency, lead time, change failure rate and recovery time as team signals rather than targets.
DORA metrics can give a team a useful view of software delivery, but only when everyone understands what the numbers represent. Put four unexplained figures on a dashboard and they quickly become background noise—or worse, targets that encourage people to optimize the measurement instead of the system.
The four familiar signals are deployment frequency, lead time for changes, change failure rate and time to restore service. Read together, they describe pace and stability. None of them is a complete verdict on a team.
Define a deployment before measuring frequency
A deployment might mean a production release, a successful workflow run, a container promoted into an environment or a feature made available to users. Choose one definition that matches how the product actually reaches customers and document it beside the metric.
Deployment frequency becomes useful when viewed as a trend. A sudden decrease can point to larger batches, a blocked release process or work moving into a part of the system the current definition does not capture. The number starts a question; it does not answer it.
Keep lead time boundaries consistent
Lead time for changes needs a clear starting point and end point. Teams commonly measure from first commit to production or from pull request creation to deployment. Either can be helpful, but comparing them as if they were the same measure creates a false story.
If GitHub is the available source, state the approximation honestly. A repository event can show when code was opened, merged or associated with a release, but it may not represent every step in a company's delivery process.
Track the median rather than only the average so a handful of very old changes do not obscure the normal experience. Keep a view of the older outliers too; they often contain the most useful process lessons.
Give failure rate a shared definition
Change failure rate is the proportion of deployments that require remediation. The hard part is deciding what counts as remediation. A rollback, hotfix, incident or failed production deployment may all qualify, depending on the team's system.
Write the definition down and keep it stable long enough to observe a trend. If the definition changes, annotate the change. A cleaner number caused by a narrower definition is not an improvement in reliability.
Measure recovery around user impact
Time to restore service is most meaningful when it follows an event that affected users. Measuring every failed development check as an outage will make the number easy to collect and difficult to interpret.
If incident data is not connected, label any GitHub-derived recovery signal as an estimate. Honest partial data is more valuable than precise-looking data that claims too much.
Read pace and stability together
No single DORA metric should be optimized alone. Increasing deployment frequency by shipping smaller changes can reduce risk, but pushing incomplete work merely to increase a count helps nobody. Driving failure rate toward zero can also encourage teams to avoid necessary changes.
A balanced review asks:
- Are changes moving through the system in smaller, more predictable batches?
- When something fails, can the team understand and recover from it quickly?
- Are trends consistent across repositories, or is one service hiding behind an aggregate?
- Did a tooling, staffing or architecture change explain the movement?
Use a review cadence that fits the signal
Operational alerts deserve immediate attention. Delivery trends usually do not. Review DORA metrics weekly or monthly with enough context to distinguish a real shift from normal variation.
Keep the dashboard compact: current values, a short trend, the measurement window and a link to the underlying work. Avoid rankings between teams whose products and deployment models differ. Use the data to improve a team's own system over time.
Metrics earn their place when they help people decide what to investigate next. Clear definitions, honest limitations and a consistent review habit turn DORA metrics from decorative numbers into useful engineering signals.