Official Datadog CLI for CI/CD test uploads, deployment events and gates, synthetic test runs, and serverless instrumentation.
$npm install -g @datadog/datadog-ci
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
Datadog CI is Datadog's CLI for pushing CI/CD metadata into Datadog and for making targeted changes around test visibility, deployments, synthetic tests, and serverless instrumentation. It is mainly a pipeline companion: run it in CI or after deploys to upload reports, annotate traces, evaluate gates, or instrument supported cloud services.
What It Enables
- Upload JUnit, coverage, SARIF, SBOM, sourcemaps, debug symbols, and git metadata so Datadog can correlate tests, code, and releases.
- Mark deployments, correlate images or GitOps deployments to commits, evaluate deployment gates, and add custom tags, measures, or traced commands to CI jobs.
- Run Datadog Synthetic tests from CI and instrument or uninstrument supported Lambda, Cloud Run, Azure App Services, Container Apps, and Step Functions workflows without changing app code by hand.
Agent Fit
- Most commands are non-interactive by default and designed for CI execution, with dry-run options and clear exit behavior on flows such as
deployment gate. - Some structured output exists, but much of the CLI is write-heavy upload or mutation work that logs human-readable progress instead of returning rich objects for downstream parsing.
- Unattended use still depends on Datadog API or app keys and, for cloud instrumentation commands, valid AWS, GCP, or Azure credentials; some serverless commands also offer interactive prompt modes.
Caveats
- This is not a general Datadog admin CLI: the repo focuses on CI/CD, testing, release correlation, and supported instrumentation workflows, not broad Datadog resource management such as monitors.
- Several high-value commands assume you are already in CI, inside a git repo, or authenticated to the relevant cloud provider and Datadog account.