How to Uninstall the DigitalOcean Metrics Agent
Validated on 3 Jul 2025 • Last edited on 14 Jul 2025
DigitalOcean Monitoring is a free, opt-in service that lets you track Droplet resource usage in real time, visualize performance metrics, and receive alerts via email or Slack to proactively manage your infrastructure’s health.
If you no longer need to monitor your Droplet’s metrics, you can uninstall the metrics agent using your system’s package manager and remove its repository configuration.
Check Which Operating System Your Droplet Uses
Uninstalling the metrics agent from your Droplet depends on your operating system and what package manager it uses. For example, Ubuntu and Debian use apt, while CentOS and Fedora use yum. To check which operating system your Droplet is running, use the following command:
cat /etc/os-releaseFor example, if your Droplet uses Ubuntu, you see output similar to this:
NAME="Ubuntu"
VERSION="22.04.4 LTS (Jammy Jellyfish)"
ID=ubuntu
ID_LIKE=debian
PRETTY_NAME="Ubuntu 22.04.4 LTS"
VERSION_ID="22.04"Uninstall Metrics Agent
Uninstalling the DigitalOcean metrics agent depends on your operating system. After you check which operating system your Droplet uses, follow the steps for your system to remove the do-agent package and delete the repository configuration file.
To remove the metrics agent, remove the do-agent package and all associated configuration files:
sudo apt-get purge do-agentYou should see output showing that apt has found the do-agent package and is ready to remove it along with its configuration files. When prompted, type Y, and then press ENTER to confirm the uninstallation.
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following packages will be REMOVED:
do-agent*
0 upgraded, 0 newly installed, 1 to remove and 168 not upgraded.
After this operation, 13.1 MB disk space will be freed.
Do you want to continue? [Y/n] After confirming, you should see output confirming the agent was removed, its configuration purged, and any system services cleaned up. The warnings about stopping or disabling the service simply mean the service was not actively running at the time of removal.
(Reading database ... 76054 files and directories currently installed.)
Removing do-agent (3.17.1) ...
Cleaning up systemd scripts
Removed '/etc/systemd/system/multi-user.target.wants/do-agent.service'.
removed '/etc/cron.daily/do-agent'
(Reading database ... 76047 files and directories currently installed.)
Purging configuration files for do-agent (3.17.1) ...
Cleaning up systemd scripts
Failed to stop do-agent.service: Unit do-agent.service not loaded.
Failed to disable unit: Unit do-agent.service does not existIf you installed the agent using the repository method, also remove the repository configuration:
sudo rm /etc/apt/sources.list.d/digitalocean-agent.listThis command produces no output if successful. To verify that the file was removed, run the following command that checks if the repository file still exists:
test -f /etc/apt/sources.list.d/digitalocean-agent.list && echo "Repo still exists" || echo "Repo successfully removed"If the removal was successful, then you should see the echo message confirming it:
...
Repo successfully removedTo remove the metrics agent, remove the do-agent package from your system:
sudo yum remove do-agentThe command returns output confirming that yum found the do-agent package and is ready to remove it. When prompted, type Y, and then press ENTER to proceeed with the uninstallation.
Package Arch Version Repository Size
Removing:
do-agent x86_64 3.17.1-1 sonar 12.5 MiB
Transaction Summary:
Removing: 1 package
Is this ok [y/N]: After confirming, the installation returns output confirming the agent was successfully removed from your Droplet.
Running transaction
[1/2] Prepare transaction 100% | 47.0 B/s | 1.0 B | 00m00s
[2/2] Erasing do-agent-0:3.17.1-1.x86_64 100% | 3.0 B/s | 5.0 B | 00m01s
Complete!Then, if you installed via downloading the metrics agent repository, remove the repository configuration by deleting the YUM repository file:
sudo rm /etc/yum.repos.d/digitalocean-agent.repoThis command doesn’t produce any output if successful. To verify that the file was removed, run this command, which checks if the repository file still exists:
test -f /etc/yum.repos.d/digitalocean-agent.repo && echo "Repo still exists" || echo "Repo successfully removed"The command returns an echo message confirming that the removal was successful:
...
Repo successfully removedVerify Uninstallation is Successful
To confirm that the metrics agent is fully removed from your Droplet, check the service status:
systemctl status do-agentIf the uninstallation was successful, the output should state that the do-agent service no longer exists and the agent is fully uninstalled:
Unit do-agent.service could not be found.If the do-agent service still appears or is listed as active, repeat the uninstallation steps or contact DigitalOcean support for assistance.