Last updated 23th August, 2019
CollectD is a Unix daemon that collects, transfers and stores performance data of computers and network equipment. In this guide, you will learn how to configure it for Metrics Data Platform.
- a valid Metrics account.
- a UNIX/Linux machine
What is CollectD
Collectd gathers metrics from various sources, e.g. the operating system, applications, logfiles and external devices, and stores this information or makes it available over the network. Those statistics can be used to monitor systems, find performance bottlenecks (i.e. performance analysis) and predict future system load (i.e. capacity planning).
To ensure using the last release, please refer to the official installation guide located on CollectD website.
Install Warp 10™ plugin
In order to use CollectD with Metrics, you need to add an additional plugin. You can start by creating a scripts directory
$ mkdir -p /etc/collectd/scripts
Then, add the Warp 10™ plugin into the availables scripts
$ curl -s 'https://raw.githubusercontent.com/ovh/collectd-write-warp10/master/write_warp10.py' > '/etc/collectd/scripts/write_warp10.py'
Collectd works with plugins, we need to load the Python one to load our Warp 10™ plugin.
This plugin is developped and maintained by OVH teams on their own infrastructures. It's goal is to push by an efficient way all CollectD metrics into the Metrics platform
to enable it:
add the following lines in the Collectd configuration file (mostly etc/collectd/collectd.conf)
LoadPlugin python <Plugin python> ModulePath "/etc/collectd/scripts" LogTraces true Interactive false Import "write_warp10" <Module write_warp10> DefaultLabel host "serverXXX" Token "METRICS_WRITE_TOKEN" URL "https://warp10.gra1.metrics.ovh.net/api/v0/update" </Module> </Plugin>
Finaly, replace METRICS_WRITE_TOKEN with a Metrics write token (you can get one on the Metrics manager)
Depanding of your infrastructure, you can explicitly add Labels on your metrics, that's what do DefaultLabel directive.
On the example, you can see gra1 in the URL, each Metrics project is linked to a region (gra1, bhs1, ...) replace it if needed.
A list of basic metrics is shipped on the configuration file, for example if you want to get your Apache metrics, uncomment this line:
This is the same thing to monitor HDD temperature:
- Documentation: Guides
- Vizualize your data: https://grafana.metrics.ovh.net/login
- Community hub: https://community.ovh.com
- Create an account: Try it free!