DigitalOcean Agent
Overview
do-agent enables droplet metrics to be gathered and sent to DigitalOcean to provide resource usage graphs and alerting.
DO Agent currently supports:
- Ubuntu 14.04+
- Debian 8+
- Fedora 27+
- CentOS 6+
- Docker (see below)
Installation
To install the do-agent on new Droplets simply select the Monitoring checkbox on the Droplet create screen to get the latest stable version of do-agent. Use your OS package manager (yum/dnf/apt-get) to update and manage do-agent.
Installing via package managers
Deb Repository
echo "deb https://repos.sonar.digitalocean.com/apt main main" > /etc/apt/sources.list.d/sonar.list
curl https://repos.sonar.digitalocean.com/sonar-agent.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get install do-agent
Yum Repository
cat <'EOF' > /etc/yum.repos.d/DigitalOcean-Sonar.repo
[sonar]
name=do agent
baseurl=https://repos.sonar.digitalocean.com/yum/$basearch
failovermethod=priority
enabled=1
gpgcheck=1
gpgkey=https://repos.sonar.digitalocean.com/sonar-agent.asc
EOF
rpm --import https://repos.sonar.digitalocean.com/sonar-agent.asc
yum install do-agent
Development
Requirements
git clone git@github.com:digitalocean/do-agent.git \
$GOPATH/src/github.com/digitalocean/do-agent
cd !$
# build the project
make
# add dependencies
dep ensure -v -add <import path>
Uninstall
do-agent can be uninstalled with your distribution's package manager
apt remove do-agent for Debian based distros
yum remove do-agent for RHEL based distros
Run as a Docker container
You can optionally run do-agent as a docker container. In order to do so
you need to mount the host directory /proc to /host/proc.
For example:
docker run \
-v /proc:/host/proc:ro \
-v /sys:/host/sys:ro \
digitalocean/do-agent:1
Report an Issue
Feel free to open an issue if one does not already exist