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:
On Debian-based operating systems (like Ubuntu), use
sudo apt-get purge do-agent
On RHEL-based operating systems (like CentOS and Fedora), use
sudo yum remove do-agent
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.