The files in this directory may be used to perform common tasks that aren't exactly `collectd's job. They may or may not require in-depth knowledge of RRD files and/or `collectd's inner workings. Use at your own risk. add_rra.sh ---------- Before version 3.9.0 collectd used to create a different set of RRAs. The most detailed of these old RRAs had a one minute resolution. This script can be used to add three more RRAs: minimum, maximum and average with a ten second resolution and 2200 rows (~6 hours). This will make hourly statistics much more interesting. Please note that no sanity- checking whatsoever is performed. You can seriously fuck up your RRD files if you don't know what you're doing. collectd-network.py ------------------- This Python module by Adrian Perez implements the collectd network protocol in pure Python. It currently supports to receive data and notifications from collectd. collectd.service ---------------- Service file for systemd. Please ship this file as /lib/systemd/system/collectd.service in any linux package of collectd. collectd-unixsock.py -------------------- This Python module by Clay Loveless provides an interface to collect's unixsock plugin. collectd2html.pl ---------------- This script by Vincent Stehlé will search for RRD files in `/var/lib/collectd/' and generate an HTML file and a directory containing several PNG files which are graphs of the RRD files found. collection.cgi -------------- Sample CGI script that creates graphs on the fly. The Perl modules `RRDs' (Debian package `librrds-perl'), `URI:Escape' (package liburi-perl), `HTML::Entities' (package libhtml-parser-perl) and a CGI capable web server (e.g. apache2 or boa) are needed. Simply install the script to a place where the webserver will treat it as a CGI script (/usr/lib/cgi-bin/ by default) and visit that page in a browser (http://localhost/cgi-bin/collection.cgi by default). Please refer to your webserver's documentation for more details. Starting with version 4, collection.cgi requires a small config file, which should look something like this: datadir: "/var/lib/collectd/rrd/" libdir: "/usr/lib/collectd/" docker/ ------- Sample docker setup using an LD_PRELOAD wrapper to redirect system calls accessing /proc and /sys to prefixed bind-mounts inside the container. Drop your collectd configuration snippets in the contrib/docker/collectd.conf.d/ directory, and build an image including them: $ docker build -t my_collectd ./contrib/docker/ Then run it with the required bind-mounts: $ docker run -it --rm \ -v /proc:/rootfs/proc:ro -v /sys:/rootfs/sys:ro \ --name collectd my_collectd $ docker exec -it collectd collectdctl listval exec-munin.px ------------- Script to be used with the exec-plugin (see collectd-exec(5) for details) which executes munin plugins, parses the output and translates it to a format the exec-plugin understands. The features are limited - changing the munin plugins to use the output format understood by the exec-plugin is recommended. See the embedded POD documentation for more details: $ perldoc contrib/exec-munin.px exec-smartctl ------------- Sample script for the exec plugin. Please refer to the documentation in the file - you will have to adapt it to your needs anyway. extractDS.px ------------ Creates a new RRD-file with only one data-source (DS) of the source-RRD- file. That is very handy when you realise that you have bundled up DSes in one RRD-file that should have been in multiple RRD-files instead. Is is used by `migrate-3-4.px' to split up the cpu-, nfs-, swap-files and possibly others. GenericJMX.conf --------------- Example configuration file for the ‘GenericJMX’ Java plugin. Please read the documentation at the beginning of the file for more details. migrate-3-4.px -------------- Migration-script to ease the switch from version 3 to version 4. Many RRD-files are expected in a different place, some have been changed (DSes have been renamed) and others have bee split up into multiple files. This script prints a bash-script to STDOUT which should do most of the work for you. You may still need to do some things by hand, read `README.migration' for more details. redhat/ ------- Spec-file and affiliated files to build an RedHat RPM package of collectd. snmp-data.conf -------------- Sample configuration for the SNMP plugin. This config includes a few standard definitions that you can include in your own config using the `Include' statement (available since version 4.2.0). The config includes some data that is defined in the IF-MIB, e. g. octet or packet counters, UPS-MIB and whatever people have send in. If you have some more definitions please send them in, so others can profit from it. solaris-smf ----------- Manifest file for the Solaris SMF system and detailed information on how to register collectd as a service with this system.