Monitoring Quickstart

To follow along, you will need a DigitalOcean account. If you don’t already have one, you can register on the sign up page.

Install the DigitalOcean Metrics Agent during Droplet Creation

The easiest way to install the DigitalOcean metrics agent on a Droplet is during creation.

To install the metrics agent when you create a Droplet:

  1. From the Droplet create page, in the Additional Options section, check Monitoring.
  2. When you’ve selected all of your options, click the Create button at the bottom of the page.

The metrics agent will be automatically installed and enabled during the Droplet creation process.

Once the metrics agent is enabled and has gathered enough data, the Graphs section of your Droplet’s detail page will display extended metrics and new graphs.

Install the DigitalOcean Metrics Agent on Existing Droplets

You can use DigitalOcean’s installation script to enable the metrics agent on an existing Droplet. The script adds a repository to your system and uses the native package manager to install the metrics agent.

To use the installation script, run the following command on your Droplet.

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

Once the metrics agent is enabled and has checked in, the Graphs section of your Droplet’s detail page will display extended metrics and new graphs.

Create an Alert Policy

Once the metrics agent has been installed on your Droplets, you can begin creating alert policies.

  1. From the control panel, click Monitoring in the menu, then click Create alert policy.
  2. Choose the metric you want to track, the threshold you want to alert on (above or below), and the alert interval.
  3. Select the Droplets or tags that you want to apply the alert policy to.
  4. Select an alert notification method: email or Slack.
  5. Name the alert policy and click Create alert policy.

You can view triggered and resolved alerts in the control panel. You’ll also receive emails or Slack notifications if you enabled them.

Remove the DigitalOcean Metrics Agent

To remove the DigitalOcean Agent, you can use your native package manager.

  • On Ubuntu and Debian, use sudo apt-get purge do-agent.
  • On CentOS and Fedora, use sudo yum remove do-agent.