dda

library0.33.1pypypiunverified

dda is a command-line tool designed for developing on the Datadog Agent platform. It provides a comprehensive set of utilities for contributors to set up development environments, build, test, and manage workflows for the Datadog Agent. The current version is 0.33.1, and it is actively maintained with frequent releases, supporting Python versions 3.12 and newer.

devops observability testing

pip install dda

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · DDA

dda

devopspythonv0.33.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

dda is primarily a command-line interface (CLI) tool. After installation, you interact with it directly from your terminal. The example commands show how to verify the installation and use some common development environment commands.

# Verify dda installation dda --version # Set up a development environment (example command) dda env dev up # Run agent checks (example command) dda agent check process

dda --version

Debug

Known issues

breakingThe `self telemetry log show` command was renamed to `self telemetry show log`.

fix

Update your scripts or muscle memory to use the new command: `dda self telemetry show log`.

affects: >=0.29.0

breakingThe `build bazel` command was renamed to `bzl`.

fix

Replace `dda build bazel` with `dda bzl` in your commands.

affects: >=0.28.0

breakingThe configuration section `[git.user]` was renamed to `[tools.git.author]`. The `Tool` interface in custom extensions now uses a single execution context instead of separate `format_command` and `env_vars` methods.

fix

Update your configuration files and any custom `Tool` implementations to reflect the new naming and interface changes.

affects: >=0.27.0

gotchaThe `config show` command's output destination changed from stderr to stdout. Similarly, the outdated version error message now goes to stderr.

fix

Adjust any scripts that parse or redirect output from `dda config show` to expect it on stdout. Be aware that outdated version errors will now appear on stderr.

affects: >=0.29.0

Errors

Common errors & fixes

dda: command not found

The `dda` executable is not in your system's PATH, or pip installation failed.

fix

Ensure `pip install dda` completed successfully. Verify your Python environment's script directory is included in your system's PATH. On Windows, this often involves reinstalling Python and ensuring 'Add Python to PATH' is checked, or manually adding the Scripts directory (e.g., `C:\Python312\Scripts`) to PATH.

ImportError: DLL load failed: The specified module could not be found.

Common on Windows when there's a mismatch between Python architecture (32-bit vs. 64-bit) and system libraries, or conflicting Python installations interfering with DLL loading.

fix

Ensure you have a single, consistent 64-bit Python installation if using a 64-bit OS. Check your `PATH` and `PYTHONHOME`/`PYTHONPATH` environment variables for incorrect entries. Reinstalling Python (making sure to select 'Add Python to PATH' and installing for 'All Users') can often resolve this.

Error: Your dda version is outdated. Please upgrade.

You are running an older version of the `dda` tool that is no longer compatible with the Datadog Agent's development requirements.

fix

Upgrade `dda` to the latest version using `pip install --upgrade dda`.

Upgrade

Version history

0.33.1latest on PyPI · released Mar 28, 2026

Audit

Dependencies

pythonrequiredRequired runtime environment.

Agent activity

23 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/DataDog/datadog-agent-dev ↗

packagehttps://pypi.org/project/dda/ ↗

docshttps://datadoghq.dev/datadog-agent/setup/ ↗