DORA Metrics Data Collected

Documentos > DORA Metrics > DORA Metrics Data Collected

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

DORA Metrics is in Preview.

Overview

DORA Metrics generates metrics for each one of the four core DORA Metrics, as well as events with associated tags and attributes that are available in the Events Explorer.

Default metrics

DORA Metrics provides the following default metrics:

Metric	Type	Description
`dora.deployments.count`	count	The number of deployments detected by Datadog based on your selected deployment data source.
`dora.change_lead_time`	distribution	The age in `seconds` of associated Git commits at the time of deployment.
`dora.incidents_impact`	count	Tracks the services or teams impacted by incidents. Used for change failure rate with the formula `dora.incidents_impact / dora.deployments.count`. A big time rollup of at least 1 week is recommended to account for the time difference between deployments and when the impact starts.
`dora.time_to_restore`	distribution	The time in `seconds` between an incident’s `started_at` and `finished_at` timestamps.

Default tags

All default metrics contain the following tags if any are available:

service
team
env
repository_id

Note: The severity tag is available for dora.incidents_impact and dora.time_to_restore metrics when it is provided by the failure’s data source.

For more information about using env, service, and version tags, see Getting Started with Tags.

Change lead time metrics

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

Metric	Type	Description
`dora.time_to_pr_ready`	duration	Time from when the commit is created until the PR is ready for review. This metric is only available for commits that were made before the PR was marked as ready for review.
`dora.review_time`	duration	Time from when the PR is marked ready for review until it receives the last approval. This metric is only available for commits that were made before the PR is approved.
`dora.merge_time`	duration	Time from the last approval until the PR is merged.
`dora.time_to_deploy`	duration	Time from PR merge to start of deployment. If a commit does not have an associated PR, this metric is calculated as the time from commit creation to start of deployment.
`dora.deploy_time`	duration	Time from start of deployment to end of deployment. This metric is not available if there is no deployment duration information.

These metrics are only computed when the source of the repository metadata is GitHub, and there must be a pull request (PR) associated with a commit, if any. A commit is associated with a PR if the commit is first introduced to the target branch when merging that PR. If a commit does not have an associated PR, only dora.time_to_deploy and dora.deploy_time metrics are available.

Notes:

These metrics are emitted 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.

Examine metrics in Event Management

Default DORA Metrics are available in the Events Explorer. To search and filter on your DORA Metrics events, navigate to Service Management > Event Management > Explorer and enter source:software_delivery_insights in the search query.

Events collected from DORA Metrics in the Events Explorer

These metrics can be queried programmatically by using the Query timeseries points and Query timeseries data across multiple products API endpoints with the source software_delivery_insights.