Our agent is a simple way to get your metrics into Hosted Graphite. You install it on your machines, and it collects and forwards metrics for you.
If you have any questions about the agent, get in touch.
The simplest way to get started is by pulling down our installer script.
For Debian-based systems:
curl -s https://YOUR-API-KEY@www.hostedgraphite.com/agent/installer/deb/ | sudo sh
or for RHEL-based systems:
curl -s https://YOUR-API-KEY@www.hostedgraphite.com/agent/installer/rpm/ | sudo sh
If you would like to set up installation and configuration via Puppet, Chef or a similar configuration management system, see our repository install instructions.
Once you have insalled an agent, visit the addons page and generate the Hosted Graphite Agent (Base) dashboard.
For more details of how it works on your machines, see System Layout.
Agent configuration is minimal and done via /etc/opt/hg-agent/hg-agent.conf. This is used to generate more complete configuration for diamond in /var/opt/hg-agent/diamond.conf.
Typically hg-agent.conf contains only an api_key and an endpoint:
api_key: YOUR-API-KEY endpoint: 0a0a0a0a.carbon.hostedgraphite.com
You can find the right values for these on your Hosted Graphite account page, but they should be filled in automatically by the simple install process above.
If your system requires a proxy to get HTTPS access to the Internet, you can add it here:
Logs are in /var/log/hg-agent: you can see the metrics generated by diamond in archive.log, as well as the various daemon logs supervisord.log, diamond.log, and periodic.log, e.g.
$ tail -f /var/log/hg-agent/periodic.log
Process structure and other details are described in System Layout.
You can inspect the agent as a service like any other, e.g. on Ubuntu trusty:
$ sudo service hg-agent status
If you’d like to look at things from the agent’s supervisor point of view:
$ sudo /opt/hg-agent/bin/supervisorctl --config=/etc/opt/hg-agent/supervisor.conf status
The sources used to build the agent can be followed at:
and are licensed under an MIT license.
Versions of Supervisor & Diamond included can be found in the agent build scripts.
As of version 1.8 the Hosted Graphite Agent now ships with local Carbon endpoints you can ship Graphite metrics to as usual via udp and tcp on localhost and port 2003 (by default).
You can also drop files containing metrics into /var/opt/hg-agent/drop, e.g.
my.metric 1.2 my.other.metric 3.4
which will be picked up and forwarded by the agent. This is useful particularly if you want to collect data that requires privileged access, e.g. via a small cron job.
The Agent list provides an overview of all agents associated with your account. From here, you can view the status of each agent and other information.
The coloured circle representing the State can take 3 values:
- Green: Agent is reporting normally with the correct time.
- Yellow: Agent has not reported in over 20 minutes, or is reporting with the wrong time.
- Red: Agent has reported errors in recent log messages.
An agent’s Clock Offset is the difference between the time reported by the agent and the time recorded on our server. Incorrect time can produce anomalies in metric data so it is advised to keep the agent’s clock accurate.
You can delete the record of an agent from this page, but be aware that this will not uninstall the agent. To uninstall an agent, use your package manager.
Hosted Graphite Agents can be uninstalled using your package manager.
For Debian-based systems:
sudo apt-get remove hg-agent
For RHEL-based systems:
sudo yum erase hg-agent