DORA Metrics

Track the four key engineering performance metrics — Deployment Frequency, Lead Time for Changes, Change Failure Rate, and Time to Restore — directly from your DevBar dashboard.

What are DORA metrics?

DORA metrics (from the DevOps Research and Assessment programme) are the industry standard for measuring software delivery performance. They identify the practices that distinguish high-performing engineering teams from low performers.

Deployment Frequency

deployments / day

How often your team successfully deploys to production. Elite performers deploy multiple times per day; low performers deploy fewer than once per month.

Lead Time for Changes

hours / commit

The time it takes for a code commit to reach production. Measures the efficiency of your delivery pipeline from code-complete to live.

Change Failure Rate

% of deployments

The percentage of deployments that result in a failure requiring remediation (rollback, hotfix, or incident). Elite teams stay below 5%.

Time to Restore

hours / incident

How long it takes to recover from a production failure. Measures operational resilience and incident response effectiveness.

How DevBar tracks DORA metrics

DevBar aggregates deployment events and incidents to compute your DORA metrics in real-time. There are two ways to feed data in:

1. Dashboard — manual logging

Navigate to Dashboard → DORA and use the Log deployment button to record a deployment manually. Fill in the environment, branch/ref, repository, and outcome. DevBar computes your metrics immediately after saving.

2. API — automated CI/CD

Call POST /api/v1/org/dora/deployments from your CI pipeline after every deployment. This keeps your metrics accurate without any manual effort.

Log a deployment via API

Call this endpoint from your deploy script or CI step. Use your API token as the Bearer token.

POST /api/v1/org/dora/deployments

Request

curl -X POST https://api.devbar.app/api/v1/org/dora/deployments \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "production",
    "ref": "main",
    "sha": "abc123def456",
    "repository": "my-org/my-app",
    "status": "success",
    "deployed_at": "2026-05-12T10:00:00Z"
  }'

Response (201)

{
  "data": {
    "id": "dep_abc123",
    "environment": "production",
    "repository": "my-org/my-app",
    "sha": "abc123def456",
    "status": "success",
    "deployed_at": "2026-05-12T10:00:00Z",
    "created_at": "2026-05-12T10:00:01Z"
  }
}

Fields

Field	Type	Required	Description
environment	string	yes	e.g. "production", "staging"
ref	string	no	Branch name or tag
sha	string	no	Full or short commit SHA
repository	string	no	org/repo format
status	"success" \| "failure"	yes	Outcome of the deployment
deployed_at	ISO 8601	no	Defaults to current time

DORA dashboard

The DORA dashboard shows your four key metrics over the last 30 days with trend indicators, a deployment timeline, and incident log. Use the period selector to zoom out to 90 days or a custom range.

Tip: Add the POST /api/v1/org/dora/deployments call to your CI/CD pipeline's final step so every deploy is captured automatically — no manual input needed.