The Server Density agent is delivered as an OS package for Debian & Ubuntu. The core agent is required for monitoring key metrics, with plugins installed as an additional package. Because the agent and plugins are installed as separate system packages, they'll be kept up to date as you update your OS normally.
Upgrading from agent v1? View the upgrade instructions.
You can install the agent automatically using our shell script, or with our Puppet, Chef, Ansible and Salt modules. See automatically scaling and deploying the agent.
- A device created in your server density account (Find out how to create a device in the UI)
- sudo (root access) is required but the agent runs as its own user (sd-agent) once installed.
- The agent requires sysstat to be installed to collect some key metrics. This will be installed as a dependency during installation.
- Our repository requires that apt-transport-https be installed before adding to your sources list. You can install apt-transport-https with the command:
apt-get install apt-transport-https
Add repository to apt
Prepare your server for the agent by adding the repo and update the package lists.
sudo nano /etc/apt/sources.list.d/sd-agent.list
Paste in the following then press Ctrl+X to save:
deb https://archive.serverdensity.com/ubuntu/ all main
Download and install our key:
curl -Ls https://archive.serverdensity.com/sd-packaging-public.key | sudo apt-key add -
Update the package lists:
sudo apt-get update -y
Install the agent
sudo apt-get install sd-agent
Configure the agent
sudo nano -w /etc/sd-agent/config.cfg
Enter the following values. Other settings are optional.
Restart the agent after any config changes:
sudo /etc/init.d/sd-agent restart