datadog-ci measure and tag support stage and step levels
Introduced 2026-04-07 · score 0.97
HOW TO USE IT
When recording measures or tags in a supported CI provider, set `--level stage` for Azure Pipelines, GitLab, or Jenkins, or `--level step` for GitHub. For Jenkins, update the Datadog plugin to the release required for the new environment variable.
datadog-ci measure --level stage --measures <key>:<number>datadog-ci measure --level step --measures <key>:<number>datadog-ci tag --level <stage|step> --tags <key>:<value>WHY THIS HELPS
When recording pipeline measures or tags in a supported CI environment, attach them to the relevant stage or step span.
REQUIREMENTS AND LIMITATIONS
- Version: v5.12.0
- --level: Selects the span: `stage` for the current stage, `step` for the current step. Allowed values are `pipeline`, `job`, `stage`, and `step`.
- --measures: Repeatable `key:value` pair(s); each value must be numeric.
- --tags: Repeatable `key:value` pair(s) to add as tags.
- --no-fail: Prevents command failure when data submission has issues; default is `false`.
- Prerequisite: Set `DD_API_KEY` to a valid API key; set `DD_SITE` to the Datadog site. The CLI docs list Buildkite, CircleCI, GitHub, GitLab, Azure Pipelines, and Jenkins as supported providers.
- Prerequisite: The release note says Jenkins needs a new Datadog plugin release for the new environment variable; it does not give the required plugin version.
- Stages are supported for Azure, GitLab, and Jenkins.
- Steps are supported for GitHub Actions.
- The Jenkins environment variable requires the new release of the Datadog plugin.
FIRST-PARTY EVIDENCE
- https://github.com/DataDog/datadog-ci/releases/tag/v5.12.0
- https://github.com/DataDog/datadog-ci/pull/2180
- https://raw.githubusercontent.com/DataDog/datadog-ci/v5.12.0/packages/base/src/commands/measure/README.md
- https://raw.githubusercontent.com/DataDog/datadog-ci/v5.12.0/packages/base/src/commands/tag/README.md
Check the installed version and the source before using it. Entry JSON