Upgrade to Datadog Agent v7

Upgrade to Datadog Agent v7

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

From Agent v6 to Agent v7

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

    PlatformCommand
    Amazon LinuxDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
    CentOSDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
    DebianDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
    FedoraDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
    Red HatDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
    UbuntuDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
    SUSEDD_AGENT_MAJOR_VERSION=7 DD_API_KEY="<DATADOG_API_KEY>" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.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 in order 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://s3.amazonaws.com/dd-agent/scripts/install_mac_os.sh)"

    From Agent v5 to Agent v7

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

      PlatformCommand
      Amazon LinuxDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
      CentOSDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
      DebianDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
      FedoraDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
      Red HatDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
      UbuntuDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)"
      SUSEDD_AGENT_MAJOR_VERSION=7 DD_UPGRADE="true" bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.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" in order 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://s3.amazonaws.com/dd-agent/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:

      Migrate your Custom Checks from python 2 to python 3DOCUMENTATION more more