# How to Uninstall the DigitalOcean Metrics Agent

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.

**Note**: **Data Retention Disclosure:** After uninstalling the DigitalOcean metrics agent, system telemetry data already processed by the agent remains in our database for 90 days, after which it is automatically deleted.

## 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:

```shell
cat /etc/os-release
```

For example, if your Droplet uses Ubuntu, you see output similar to this:

```text
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](#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.

## Ubuntu and Debian

To remove the metrics agent, remove the `do-agent` package and all associated configuration files:

```shell
sudo apt-get purge do-agent
```

You 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.

```text
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.

```text
(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 exist
```

If you installed the agent [using the repository method](https://docs.digitalocean.com/products/monitoring/how-to/install-metrics-agent-repository/index.html.md), also remove the repository configuration:

```shell
sudo rm /etc/apt/sources.list.d/digitalocean-agent.list
```

This 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:

```shell
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:

```text
...
Repo successfully removed
```

## CentOS and Fedora

To remove the metrics agent, remove the `do-agent` package from your system:

```shell
sudo yum remove do-agent
```

The 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.

```text
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.

```text
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](https://docs.digitalocean.com/products/monitoring/how-to/install-metrics-agent-repository/index.html.md), remove the repository configuration by deleting the YUM repository file:

```shell
sudo rm /etc/yum.repos.d/digitalocean-agent.repo
```

This 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:

```shell
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:

```text
...
Repo successfully removed
```

## Verify Uninstallation is Successful

To confirm that the metrics agent is fully removed from your Droplet, check the service status:

```shell
systemctl status do-agent
```

If the uninstallation was successful, the output should state that the `do-agent` service no longer exists and the agent is fully uninstalled:

```text
Unit do-agent.service could not be found.
```

If the `do-agent` service still appears or is listed as active, [repeat the uninstallation steps](#uninstall) or [contact DigitalOcean support](https://cloudsupport.digitalocean.com) for assistance.