Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
SpamAssassin
aix
collection3
examples
fedora
iptables
oracle
php-collection
python
redhat
sles10.1
solaris-smf
GenericJMX.conf
README
add_rra.sh
collectd2html.pl
collectd_network.py
collectd_unix_sock.rb
collectd_unixsock.py
collection.cgi
collection.conf
cussh.pl
exec-ksm.sh
exec-munin.conf
exec-munin.px
exec-nagios.conf
exec-nagios.px
exec-smartctl
migrate-3-4.px
migrate-4-5.px
network-proxy.py
rrd_filter.px
snmp-data.conf
snmp-probe-host.px

README

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-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/"

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.

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
--------------
  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
<Data ..> 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.