X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=README;h=e47493ac23c4acb1f6809f30a138ea7a6d062a8b;hb=bc51ef217e871b80152eccd4e5f32659500f75f3;hp=9b06f64280162c8aa3ef376b72b6aea00e145c0c;hpb=b5cac450499d563e64a499082866acf846200410;p=collectd.git diff --git a/README b/README index 9b06f642..e47493ac 100644 --- a/README +++ b/README @@ -33,6 +33,19 @@ Features Batterycharge, -current and voltage of ACPI and PMU based laptop batteries. + - curl + Parse statistics from websites using regular expressions. + + - bind + Name server and resolver statistics from the `statistics-channel' + interface of BIND 9.5, 9,6 and later. + + - conntrack + Number of nf_conntrack entries. + + - couchdb + Parse statistics from CouchDB JSON documents. + - cpu CPU utilization: Time spent in the system, user, nice, idle, and related states. @@ -69,6 +82,9 @@ Features - filecount Count the number of files in directories. + - gmond + Receive multicast traffic from Ganglia instances. + - hddtemp Harddisk temperatures using hddtempd. @@ -91,6 +107,10 @@ Features - irq IRQ counters: Frequency in which certain interrupts occur. + - java + Integrates a `Java Virtual Machine' (JVM) to execute plugins in Java + bytecode. See “Configuring with libjvm” below. + - load System load average over the last 1, 5 and 15 minutes. @@ -150,6 +170,9 @@ Features RX and TX of each client in openvpn-status.log (status-version 2). + - oracle + Query data from an Oracle database. + - perl The perl plugin implements a Perl-interpreter into collectd. You can write your own plugins in Perl and return arbitrary values using this @@ -169,6 +192,9 @@ Features - processes Process counts: Number of running, sleeping, zombie, ... processes. + - protocols + Counts various aspects of network protocols such as IP, TCP, UDP, etc. + - rrdcached RRDtool caching daemon (RRDcacheD) statistics. @@ -200,6 +226,9 @@ Features - teamspeak2 TeamSpeak2 server statistics. + - ted + Plugin to read values from `The Energy Detective' (TED). + - thermal Linux ACPI thermal zone information. @@ -254,13 +283,6 @@ Features needed. Please read collectd-unixsock(5) for a description on how that's done. - * Filtering and rewriting values dispatched to collectd can be done by the - following plugins: - - - filter_pcre - Filter and rewrite value lists based on Perl-compatible regular - expressions. - * Logging is, as everything in collectd, provided by plugins. The following plugins keep up informed about what's going on: @@ -300,6 +322,27 @@ Features Notifications are propagated to plugins written in Perl as well. See collectd-perl(5). + * Value processing can be controlled using the "filter chain" infrastructure + and "matches" and "targets". The following plugins are available: + + - match_regex + Match values by their identifier based on regular expressions. + + - match_timediff + Match values with an invalid timestamp. + + - match_value + Select values by their data sources' values. + + - target_notification + Create and dispatch a notification. + + - target_replace + Replace parts of an identifier using regular expressions. + + - target_set + Set (overwrite) entire parts of an identifier. + * Miscellaneous plugins: - uuid @@ -376,8 +419,11 @@ Prerequisites particular. + * libclntsh (optional) + Used by the `oracle' plugin. + * libcurl (optional) - If you want to use the `apache', `ascent', or `nginx' plugin. + If you want to use the `apache', `ascent', `curl' or `nginx' plugin. * libdbi (optional) @@ -397,6 +443,11 @@ Prerequisites For querying iptables counters. + * libjvm (optional) + Library that encapsulates the `Java Virtual Machine' (JVM). This library is + used by the Java plugin to execute Java bytecode. See “Configuring with + libjvm” below. + * libmysqlclient (optional) Unsurprisingly used by the `mysql' plugin. @@ -427,10 +478,6 @@ Prerequisites Used to capture packets by the `dns' plugin. - * libpcre (optional) - Used by the `filter_pcre' plugin. - - * libperl (optional) Obviously used by the `perl' plugin. The library has to be compiled with ithread support (introduced in Perl 5.6.0). @@ -474,6 +521,9 @@ Prerequisites * libxmms (optional) + * libyajl (optional) + Parse JSON data. This is needed for the `couchdb' plugin. + Configuring / Compiling / Installing ------------------------------------ @@ -499,6 +549,42 @@ Configuring / Compiling / Installing prefixed to all installation directories. This might be useful when creating packages for collectd. +Configuring with libjvm +----------------------- + + To determine the location of the required files of a Java installation is not + an easy task, because the locations vary with your kernel (Linux, SunOS, …) + and with your architecture (x86, SPARC, …) and there is no ‘java-config’ + script we could use. Configuration of the JVM library is therefore a bit + tricky. + + The easiest way to use the `--with-java=$JAVA_HOME' option, where + `$JAVA_HOME' is usually something like: + /usr/lib/jvm/java-1.5.0-sun-1.5.0.14 + + The configure script will then use find(1) to look for the following files: + + - jni.h + - jni_md.h + - libjvm.so + + If found, appropriate CPP-flags and LD-flags are set and the following + library checks succeed. + + If this doesn't work for you, you have the possibility to specify CPP-flags, + C-flags and LD-flags for the ‘Java’ plugin by hand, using the following three + (environment) variables: + + - JAVA_CPPFLAGS + - JAVA_CFLAGS + - JAVA_LDFLAGS + + For example (shortened for demonstration purposes): + + ./configure JAVA_CPPFLAGS="-I$JAVA_HOME/include -I$JAVA_HOME/include/linux" + + Adding "-ljvm" to the JAVA_LDFLAGS is done automatically, you don't have to + do that. Crosscompiling -------------- @@ -518,12 +604,24 @@ Crosscompiling that the compiled binary actually behaves as it should, but since NANs are likely never passed to the libm you have a good chance to be lucky. + Likewise, collectd needs to know the layout of doubles in memory, in order + to craft uniform network packets over different architectures. For this, it + needs to know how to convert doubles into the memory layout used by x86. The + configure script tries to figure this out by compiling and running a few + small test programs. This is of course not possible when cross-compiling. + You can use the `--with-fp-layout' option to tell the configure script which + conversion method to assume. Valid arguments are: + + * `nothing' (12345678 -> 12345678) + * `endianflip' (12345678 -> 87654321) + * `intswap' (12345678 -> 56781234) + Contact ------- - For questions, bugreports, development information and basically all other - concerns please send an email to collectd's mailinglist at + For questions, bug reports, development information and basically all other + concerns please send an email to collectd's mailing list at . For live discussion and more personal contact visit us in IRC, we're in @@ -537,5 +635,6 @@ Author Sebastian tokkee Harl , and many contributors (see `AUTHORS'). - Please send bugreports and patches to the mailinglist, see `Contact' above. + Please send bug reports and patches to the mailing list, see `Contact' + above.