DigitalOcean Home

How to Upgrade from the Legacy Metrics Agent to the Current Agent

On 8 April, 2019, we released a new Prometheus-based metrics agent into production. All agent installations on or after this date will receive the new agent by default. On 8 July, 2019, the legacy metrics agent will be deprecated, meaning users will no longer be able to view metrics from Droplets running the legacy agent. You can upgrade to the new agent at any time.

If you want to install the metrics agent for the first time, refer to the agent installation instructions. If you are currently running the legacy metrics agent, follow the instructions here to upgrade.

The upgrade process involves two steps:

  1. Uninstall the legacy metrics agent.

    On Debian-based operating systems (like Ubuntu), use apt-get:

    sudo apt-get purge do-agent

    On RHEL-based operating systems (like CentOS and Fedora), use yum:

    sudo yum remove do-agent
  2. Install the current metrics agent.

    You can do this by automatically running the installation script with curl ... | bash, as below, or you can download the script, inspect it, and run it manually.

    curl -sSL https://insights.nyc3.cdn.digitaloceanspaces.com/install.sh | sudo bash

You can update multiple Droplets at once with the upgrade-droplets.sh script provided in the do-agent GitHub repository. You’ll need an SSH key and a DigitalOcean API token.

Alternatively, an Ansible-based batch upgrade is available on Ansible Galaxy.