Upgrade to Datadog Agent 7

Agent 7 only supports Python 3 custom checks. Check if your custom checks are Python 3 compatible before upgrading to Agent 7.

From Agent 6

Run the following Agent installation command to upgrade your Agent from version 6 to version 7:

The following command works on Amazon Linux, CentOS, Debian, Fedora, Red Hat, Ubuntu, and SUSE:
DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
  1. Download the Datadog Agent installer.
  2. Run the installer (as Administrator) by opening datadog-agent-7-latest.amd64.msi.
  3. Follow the prompts, accept the license agreement, and enter your Datadog API key.
  4. When the install finishes, you are given the option to launch the Datadog Agent Manager.

Note: Links to all available versions of the Windows Installer are provided in JSON format.

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 to upgrade your Agent from version 6 to version 7:

DD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_mac_os.sh)"

From Agent 5

Run the Agent installation command with the environment variable DD_UPGRADE="true" to upgrade your Agent from version 5 to version 7. The Agent v7 installer can automatically convert v5 configurations during the upgrade:

The following command works on Amazon Linux, CentOS, Debian, Fedora, Red Hat, Ubuntu, and SUSE:
DD_UPGRADE="true" bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
  1. Upgrade your Agent to version 6 following the manual upgrade process.
  2. Follow the From Agent v6 to Agent v7 upgrade instructions.

Run the Agent installation command with the environment variable DD_AGENT_MAJOR_VERSION=7 and DD_UPGRADE="true" to upgrade your Agent from version 5 to version 7. The Agent v7 installer can automatically convert v5 configurations during the upgrade:

DD_UPGRADE="true" DD_AGENT_MAJOR_VERSION=7 bash -c "$(curl -L https://install.datadoghq.com/scripts/install_mac_os.sh)"

Note: The upgrade process won’t automatically move custom Agent checks. This is by design as Datadog cannot guarantee full backwards compatibility out of the box. See the Python 3 Custom Check Migration guide to discover how to migrate your custom check from Python 2 to Python 3.

Further Reading

Additional helpful documentation, links, and articles:

PREVIEWING: piotr_wolski/update-dsm-docs