Datadog Agent Development Tool (dda)

0.33.1 · active · verified Thu Apr 16

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.

Common errors

```
dda: command not found
```
cause 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.
```
cause 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.
```
cause 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`.

Warnings

breaking The `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`.
breaking The `build bazel` command was renamed to `bzl`.
Fix: Replace `dda build bazel` with `dda bzl` in your commands.
breaking The 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.
gotcha The `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.

Install

pip install dda Install latest version

Quickstart

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

view raw JSON →