@datadog/datadog-ci
Advanced tools
@datadog/datadog-ci is an npm package that provides a set of tools to interact with Datadog from your CI/CD pipelines. It allows you to upload test results, monitor performance, and manage various Datadog resources programmatically.
Upload JUnit XML Test Reports
This feature allows you to upload JUnit XML test reports to Datadog. It helps in tracking test results and visualizing them in Datadog dashboards.
const { uploadJUnitXML } = require('@datadog/datadog-ci');
uploadJUnitXML({
service: 'my-service',
files: ['test-results.xml'],
tags: ['env:ci', 'team:backend'],
datadogSite: 'datadoghq.com',
apiKey: 'your-datadog-api-key'
}).then(() => {
console.log('Test results uploaded successfully');
}).catch((error) => {
console.error('Error uploading test results:', error);
});Synthetics Command
This feature allows you to run Datadog Synthetics tests from your CI/CD pipeline. It helps in monitoring the performance and availability of your applications.
const { synthetics } = require('@datadog/datadog-ci');
synthetics.runTests({
publicIds: ['abc-123', 'def-456'],
datadogSite: 'datadoghq.com',
apiKey: 'your-datadog-api-key',
appKey: 'your-datadog-app-key'
}).then((results) => {
console.log('Synthetics tests results:', results);
}).catch((error) => {
console.error('Error running synthetics tests:', error);
});API Test
This feature allows you to run API tests defined in a configuration file. It helps in ensuring the reliability and correctness of your APIs.
const { apiTest } = require('@datadog/datadog-ci');
apiTest.run({
configPath: './api-test-config.json',
datadogSite: 'datadoghq.com',
apiKey: 'your-datadog-api-key',
appKey: 'your-datadog-app-key'
}).then((results) => {
console.log('API test results:', results);
}).catch((error) => {
console.error('Error running API tests:', error);
});jest-junit is a Jest reporter that creates compatible JUnit XML files. It is similar to the JUnit XML upload feature of @datadog/datadog-ci but is specific to Jest test results.
Newman is a command-line collection runner for Postman. It allows you to run and test Postman collections directly from the command line. It is similar to the API test feature of @datadog/datadog-ci but is specific to Postman collections.
Cypress is a JavaScript end-to-end testing framework. It provides a rich set of features for writing and running tests for web applications. It is similar to the Synthetics command feature of @datadog/datadog-ci but is a more comprehensive testing framework.
Execute commands from your Continuous Integration (CI) and Continuous Delivery (CD) pipelines to integrate with existing Datadog products.
See the Usage section for a list of available commands.
The package is under @datadog/datadog-ci and can be installed through NPM or Yarn:
# NPM
npm install --save-dev @datadog/datadog-ci
# Yarn
yarn add --dev @datadog/datadog-ci
If you need datadog-ci as a CLI tool instead of a package, you can run it with npx or install it globally:
# npx
npx @datadog/datadog-ci [command]
# NPM install globally
npm install -g @datadog/datadog-ci
# Yarn v1 add globally
yarn global add @datadog/datadog-ci
For more ways to install the CLI, see this section.
Usage: datadog-ci <command> [<subcommand>] [options]
The following values are available for each <command> and (optionally) <subcommand>.
See each command's linked README for more details, or click on 📚 to see the related documentation page.
cloud-runflare: Troubleshoot your issues with Cloud Run service configuration. 📚dsymsupload: Upload iOS dSYM files for Error Tracking (macOS only). 📚flutter-symbolsupload: Upload Flutter symbols for Error Tracking. 📚unity-symbolsupload: Upload Unity symbols for Error Tracking.git-metadataupload: Upload Git metadata for the Source Code Integration. 📚junitupload: Upload JUnit test reports for Test Visibility. 📚lambdaflare: Troubleshoot your issues with Datadog instrumentation on your AWS Lambda functions.instrument: Apply Datadog instrumentation to the given AWS Lambda functions.uninstrument: Revert Datadog instrumentation from the given AWS Lambda functions.measurereact-nativecodepush: Upload React Native CodePush sourcemaps for Error Tracking. 📚upload: Upload React Native sourcemaps for Error Tracking. 📚xcode: Upload React Native sourcemaps for Error Tracking from the XCode bundle build phase. 📚sarifupload: Upload Static Analysis Results Interchange Format (SARIF) reports to Datadog. 📚sbomupload: Upload Software Bill of Materials (SBOM) files to Datadog. 📚sourcemapsupload: Upload JavaScript sourcemaps for Error Tracking. 📚stepfunctionsinstrument: Instrument AWS Step Function with Datadog to get logs and traces. 📚uninstrument: Uninstrument AWS Step Function. 📚syntheticsrun-tests: Run Continuous Testing tests from the CI. 📚upload-application: Upload a new version to an existing mobile application in Datadog. 📚tagtraceThe following are beta commands, you can enable them with with DD_BETA_COMMANDS_ENABLED=1:
deploymentmark: Mark a CI job as a deployment. 📚correlate: Correlate GitOps CD deployments with application repositories CI pipelines. 📚doradeployment: Send a new deployment event for DORA Metrics to Datadog. 📚elf-symbolsupload: Upload Elf debug info files for Profiling (requires binutils). 📚gateevaluate: Evaluate Quality Gates rules in Datadog. 📚If installing NodeJS in the CI is an issue, standalone binaries are provided with releases. linux-x64, linux-arm64, darwin-x64, darwin-arm64 (MacOS) and win-x64 (Windows) are supported.
To install:
curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_linux-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ci
curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_darwin-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ci
Invoke-WebRequest -Uri "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_win-x64" -OutFile "datadog-ci.exe"
Then, you can run datadog-ci commands normally:
datadog-ci version
To run datadog-ci from a container, you can use the datadog/ci image available in Docker Hub as well as the public Amazon ECR and Google GC registries.
docker pull datadog/ci
This example demonstrates how to run a command using the container and passing in the API and app keys:
export DD_API_KEY=$(cat /secret/dd_api_key)
export DD_APP_KEY=$(cat /secret/dd_app_key)
docker run --rm -it -v $(pwd):/w -e DD_API_KEY -e DD_APP_KEY datadog/ci synthetics run-tests -p pub-lic-id1
You can build an image using the provided Dockerfile:
cd container
docker build --tag datadog-ci .
Optionally, you can use the VERSION build argument to build an image for a specific version:
docker build --build-arg "VERSION=v1.14" --t datadog-ci .
Before contributing to this open source project, read our CONTRIBUTING.md.
FAQs
Run datadog actions from the CI.
The npm package @datadog/datadog-ci receives a total of 1,157,193 weekly downloads. As such, @datadog/datadog-ci popularity was classified as popular.
We found that @datadog/datadog-ci demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.