skullydazed/do-agent repository overview

⁠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 (oldest End Of Standard Support⁠ LTS release and later)
• Debian (oldest supported⁠ LTS release and later)
• Fedora 27+
• CentOS 6+
• Docker (see below)

Note:

Although, we only officially support these distros and versions, do-agent works on most Linux distributions. Feel free to run it wherever you are successful, but any issues you encounter will not have official support from DigitalOcean

⁠Special Note For SELinux Users

The do-agent install script sets the nis_enabled flag to 1. Without this setting the do-aegnt cannot reach the network to perform authentication or send metrics to DigitalOcean backend servers. If you reverse this action, or install the do-agent on a machine manually you will need to run setsebool -P nis_enabled 1 && systemctl daemon-reexec otherwise the do-agent will not operate.

⁠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

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

If you prefer to inspect the script first:

curl -L -o ./install.sh https://insights.nyc3.cdn.digitaloceanspaces.com/install.sh
# inspect the file
less ./install.sh
# execute the file
sudo ./install.sh

⁠Development

⁠Requirements

• go⁠ 1.11 or later
• GNU Make⁠
• Docker

git clone [email protected]:digitalocean/do-agent.git
cd do-agent

### build the project
make

### add dependencies
# first make sure you have the appropriate flags set to use go modules
# We recommend using https://github.com/direnv/direnv to automatically set
# these from the .envrc file in this project or you can manually set them
export GO111MODULE=on GOFLAGS=-mod=vendor

# then add your imports to any go file and run
go mod vendor

⁠Uninstall

do-agent can be uninstalled with your distribution's package manager

apt-get 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:stable

⁠Report an Issue

Feel free to open an issue⁠ if one does not already exist⁠