{"id":8076,"library":"dda","title":"Datadog Agent Development Tool (dda)","description":"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.","status":"active","version":"0.33.1","language":"en","source_language":"en","source_url":"https://github.com/DataDog/datadog-agent-dev","tags":["datadog","agent","development","cli","tooling","devops"],"install":[{"cmd":"pip install dda","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Required runtime environment.","package":"python","optional":false}],"imports":[],"quickstart":{"code":"# Verify dda installation\ndda --version\n\n# Set up a development environment (example command)\ndda env dev up\n\n# Run agent checks (example command)\ndda agent check process","lang":"bash","description":"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."},"warnings":[{"fix":"Update your scripts or muscle memory to use the new command: `dda self telemetry show log`.","message":"The `self telemetry log show` command was renamed to `self telemetry show log`.","severity":"breaking","affected_versions":">=0.29.0"},{"fix":"Replace `dda build bazel` with `dda bzl` in your commands.","message":"The `build bazel` command was renamed to `bzl`.","severity":"breaking","affected_versions":">=0.28.0"},{"fix":"Update your configuration files and any custom `Tool` implementations to reflect the new naming and interface changes.","message":"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.","severity":"breaking","affected_versions":">=0.27.0"},{"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.","message":"The `config show` command's output destination changed from stderr to stdout. Similarly, the outdated version error message now goes to stderr.","severity":"gotcha","affected_versions":">=0.29.0"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"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.","cause":"The `dda` executable is not in your system's PATH, or pip installation failed.","error":"dda: command not found"},{"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.","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.","error":"ImportError: DLL load failed: The specified module could not be found."},{"fix":"Upgrade `dda` to the latest version using `pip install --upgrade dda`.","cause":"You are running an older version of the `dda` tool that is no longer compatible with the Datadog Agent's development requirements.","error":"Error: Your dda version is outdated. Please upgrade."}]}