Skip to content

DORA Metrics retention period and requirements update #33265

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Tecoddy merged 4 commits into from
Dec 11, 2025
+7 −4
Merged

DORA Metrics retention period and requirements update #33265

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9745c4d
Added retention + small edits
Tecoddy Dec 10, 2025
ca444ed
Update content/en/dora_metrics/setup/deployments.md
Tecoddy Dec 11, 2025
1c58b7e
Update content/en/dora_metrics/setup/deployments.md
Tecoddy Dec 11, 2025
3f04de4
Merge branch 'master' into teddy.gesbert/dora_metrics_small_edits
Tecoddy Dec 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions content/en/dora_metrics/data_collected/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,9 @@ DORA Metrics generates events that have associated fields and 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
**Note**: DORA Metrics events have a 2-year retention period.

### Default tags

All events contain the following tags if any are available:

Expand All @@ -41,7 +43,7 @@ All events contain the following tags if any are available:

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

#### Custom tags
### Custom tags

In addition to the tags above, deployment and failure events can be enriched with custom tags to filter DORA Metrics. There are three potential sources for these tags:

Expand Down
5 changes: 3 additions & 2 deletions content/en/dora_metrics/setup/deployments.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,8 @@ For service deployments tracked by APM to contribute to change lead time, ensure

### Requirements for calculating change lead time
- Your application telemetry is tagged with Git information. You can enable this [in APM][101] or see the [Source Code Integration documentation][102].
- Your repository metadata is synchronized to Datadog through the [GitHub integration][103] or by the `datadog-ci git-metadata upload` command.
- Your repository metadata is [synchronized](#synchronize-repository-metadata-to-datadog) to Datadog.


[101]: https://app.datadoghq.com/source-code/setup/apm
[102]: /integrations/guide/source-code-integration/?tab=go#tag-your-telemetry-with-git-information
Expand All @@ -174,7 +175,7 @@ For service deployments tracked by the DORA Metrics API or the `datadog-ci dora
### Requirements for calculating change lead time

- The attributes `repository_url` and `commit_sha` are included in the deployment events payload.
- Your repository metadata is synchronized to Datadog through the [GitHub integration][101] or by the `datadog-ci git-metadata upload` command.
- Your repository metadata is [synchronized](#synchronize-repository-metadata-to-datadog) to Datadog.

[101]: /integrations/github/

Expand Down
Loading