DORA Metrics Data Collected

Docs > DORA Metrics > DORA Metrics Data Collected

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

DORA Metrics is in Preview.

Overview

DORA Metrics generates events that have associated fields and tags.

Event Type	Description
Deployment	A single code deployment. Each deployment is uniquely identified by a specific combination of env, service, and version tags.
Commit	A commit event is generated for each individual commit included in a deployment. These events contain metadata and are automatically linked to the corresponding deployment.
Failure	A failure in production, such as an incident, rollback, or alert.

Default tags

All events contain the following tags if any are available:

service
team
env
version
source
repository_id

Note: The severity tag is available for failure events when it is provided by the failure’s data source.

For more information about using tags, see Getting Started with Tags.

DORA metrics

DORA Metrics provide the following fields:

Metric	Description
`Deployment Frequency`	The number of deployments detected by Datadog based on your selected deployment data source.
`Change Lead Time`	The age in seconds of all associated Git commits at the time of deployment.
`Change Failure Rate`	Calculated with the formula `Count of Failures/Count of Deployments`. A long time rollup of at least 1 week is recommended to account for the time difference between deployments and when the failure starts.
`Time to Restore`	The time in seconds between a failure’s `started_at` and `finished_at` timestamps.

Change lead time stages

Datadog breaks down change lead time into the following fields, which represent the different stages from commit creation to deployment.

Metric	Description
`Time to PR Ready`	Time from when the commit is created until the PR is ready for review. This metric is only available for commits made before the PR is marked as ready for review.
`Review Time`	Time from when the PR is marked ready for review until it receives the last approval. This metric is only available for commits made before the PR is approved.
`Merge Time`	Time from the last approval until the PR is merged.
`Time to Deploy`	Time from PR merge to start of deployment. If a commit has no associated PR, this metric is calculated as the time from commit creation to start of deployment.
`Deploy Time`	Time from start of deployment to end of deployment. This metric is not available if there is no deployment duration information.

These stages are only computed when the source of the repository metadata is GitHub, and for most stages there must be a pull request (PR) associated with a commit. A commit is associated with a PR if the commit is first introduced to the target branch when merging that PR. If a commit has no associated PR, only Time to Deploy and Deploy Time fields are available.

Recommendations

Using commit-level granularity provides a more accurate view of engineering performance. At the deployment level, metrics are calculated as an average of averages, which can obscure key insights. This approach treats all deployments equally, even if one contains one commit and another contains ten, misrepresenting their impact.

Notes

These fields are measured for every commit and not per deployment.
There are several edge cases depending on the way the commits were introduced to the deployment, view the limitations.

Event-specific fields

Deployment fields

Field	Description
`Duration`	Duration of the deployment.
`Avg Change Lead Time`	The average duration of change lead time of all commits.
`Avg Time to PR Ready`	The average duration of time to PR ready of all commits.
`Avg Review Time`	The average duration of review time of all commits.
`Avg Merge Time`	The average duration of merge time of all commits.
`Avg Time to Deploy`	The average duration of time to deploy of all commits.
`Number of Commits`	Count of all commits included in a deployment.

Commit fields

Field	Description
`Change Lead Time`	Duration it takes for a commit to get into production.
`Time to PR Ready`	Duration from commit creation to when the PR is marked as ready for review.
`Review Time`	Duration from PR being marked ready for review to approval.
`Merge Time`	Duration from PR approval to merging.
`Time to Deploy`	Duration from merging to start of deployment.
`Deploy Time`	Duration from start of deployment to end of deployment.