X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=contrib%2FREADME;h=6e2ea19e2ab676daaf182082415f967895297466;hb=2bc8f11d9c7182e24fb62a6efefa3e0b74ac0afb;hp=119d866bb57a57ccf1fdc3a11e1f915ed3f29a1b;hpb=658c85755ef1f4284228d1e5edbc4452a31bd944;p=collectd.git diff --git a/contrib/README b/contrib/README index 119d866b..6e2ea19e 100644 --- a/contrib/README +++ b/contrib/README @@ -13,20 +13,23 @@ 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 + 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. @@ -46,6 +49,21 @@ 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) @@ -67,10 +85,10 @@ 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. -fedora/ -------- - Init-script and Spec-file that can be used when creating RPM-packages for -Fedora. +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 --------------