index 511683f7e1f29dd767a5ea3bf6be3053477c8185..8d6c7edb4c07b5ce4db4457918c36702415f2652 100644 (file)
--- a/README
+++ b/README
- Disk utilization
(Sectors read/written, number of read/write actions, time spent doing IO)
- Disk utilization
(Sectors read/written, number of read/write actions, time spent doing IO)
+ - DNS traffic
+ (query types, response codes, opcodes and traffic)
+
+ - Email statistics
+ (count, traffic, spam scores and checks)
+
+ - Entropy available
+ (Amount of entropy available to the system)
+
+ - Exec
+ (Values gatheres by a custom program or script)
+
- Harddisk temperatures
(Uhm, yeah, temperature of harddisks that is ;)
- Harddisk temperatures
(Uhm, yeah, temperature of harddisks that is ;)
+ - Interface traffic
+ (Number of octets, packets and errors for each interface)
+
+ - Iptables' counters
+ (Number of bytes that were matched by a certain iptables rule)
+
+ - IRQ counters
+ (Frequency in which certain interrupts occur)
+
- System load
(Load average over the last 1, 5 and 15 minutes)
- System load
(Load average over the last 1, 5 and 15 minutes)
+ - mbmon - motherboard monitoring
+ (temperature, fanspeed and voltage information)
+
- Memory utilization
(Memory occupied by running processes, page cache, buffer cache and free)
- Memory utilization
(Memory occupied by running processes, page cache, buffer cache and free)
+ - Multimeter
+ (Information provided by serial multimeters, such as the «Metex M-4650CR»)
+
- MySQL server statistics
(Commands issued, handlers triggered, thread usage, query cache
utilization and traffic sent/received)
- MySQL server statistics
(Commands issued, handlers triggered, thread usage, query cache
utilization and traffic sent/received)
- NTP Daemon
(Local clock drift, offset to peers, etc)
- NTP Daemon
(Local clock drift, offset to peers, etc)
+ - Network UPS tools
+ (UPS current, voltage, power, charge, utilisation, temperature, etc.)
+
- Ping latency
(Time to reach the default gateway or another given host)
- Ping latency
(Time to reach the default gateway or another given host)
(Number of running, sleeping, zombie, ... processes)
- Sensors
(Number of running, sleeping, zombie, ... processes)
- Sensors
- (System temperatured and fan rotation speeds)
+ (lm_sensors voltages, temperatures and fan rotation speeds)
- Serial
(RX and TX of serial interfaces)
- Serial
(RX and TX of serial interfaces)
- Tape
(Read and write bytes and operations on tape devices)
- Tape
(Read and write bytes and operations on tape devices)
- - Traffic
- (In/Outbound traffic on the interfaces)
-
- Users
(Currently logged in users)
- Users
(Currently logged in users)
- Wireless
(Link quality of wireless cards)
- Wireless
(Link quality of wireless cards)
+ * Output to CSV- and RRD-files, send values over the network and/or provide a
+ generic interface for use by other means, e. g. a Nagios-plugin.
+
* Performance: Running as a daemon collectd doesn't spend much time in
startup. Since collectd links against libping, librrd and libsensors it
doesn't need to start any other processes.
* Performance: Running as a daemon collectd doesn't spend much time in
startup. Since collectd links against libping, librrd and libsensors it
doesn't need to start any other processes.
Run `collectd -h' for a list of builtin defaults. See `collectd.conf(5)'
for a list of options and a syntax description.
Run `collectd -h' for a list of builtin defaults. See `collectd.conf(5)'
for a list of options and a syntax description.
- * When running collectd writes system statistics in RRD-files. Per default
- they reside in `/var/lib/collectd'.
+ * When the `csv' or `rrdtool' plugins are loaded they'll write the values to
+ files. The usual place for these files is beneath `/var/lib/collectd'.
- * When using the `ping' plugin collectd needs to run as user root, since only
- root can craft ICMP packages needed to ping other hosts. collectd should
- NOT be installed setuid root since it can be used to overwrite valuable
- files..
+ * When using some of the plugins, collectd needs to run as user root, since only
+ root can do certain thing, such as craft ICMP packages needed to ping other
+ hosts. collectd should NOT be installed setuid root since it can be used to
+ overwrite valuable files..
* Sample scripts to generate graphs reside in `contrib/' in the source
package or somewhere near `/usr/share/doc/collectd' in most distributions.
* Sample scripts to generate graphs reside in `contrib/' in the source
package or somewhere near `/usr/share/doc/collectd' in most distributions.
(`librrds-perl' on Debian)
* The RRAs of the automatically created RRD files depend on the `step'
(`librrds-perl' on Debian)
* The RRAs of the automatically created RRD files depend on the `step'
- and `heartbeat' settings given on compile time. For a list of the
- default RRAs take a look in the collectd(1) manpage.
+ and `heartbeat' settings given. For a list of the default RRAs take a look
+ in the collectd(1) manpage.
Prerequisites
Prerequisites
* Usual suspects: C compiler, linker, preprocessor, make, ...
* Usual suspects: C compiler, linker, preprocessor, make, ...
- * rrdtool (headers and library; rrdtool 1.0 and 1.2 both work fine)
- If built without `librrd' the resulting binary will be `client only', i.e.
- will send it's values via multicast and not create any RRD files itself.
+ * A POSIX-threads (pthread) implementation.
+ Since gathering some statistics is slow (network connections, slow devices,
+ etc) the collectd is parellelized. The POSIX threads interface is being
+ used and should be found in various implementations for hopefully all
+ platforms.
+
+ * libcurl (optional)
+ If you want to use the `apache' plugin
+
+ * libiptc (optional)
+ For querying iptables counters.
* libmysqlclient (optional)
* libmysqlclient (optional)
- * lm-sensors (optional)
+ * liboping (optional, if not found a version shipped with this distribution
+ can be used)
+ Used by the `ping' plugin to send and receive ICMP packets.
+
+ * libpcap (optional)
+ Used to capture packets by the `dns' plugin.
+
+ * librrd (optional; headers and library; rrdtool 1.0 and 1.2 both work fine)
+ If built without `librrd' the resulting binary will be `client only', i.e.
+ will send it's values via multicast and not create any RRD files itself.
+ Alternatively you can chose to write CSV-files (Comma Seperated Values)
+ instead.
+
+ * libsensors (optional)
+ To read from `lm_sensors'.
* libstatgrab may be used to collect statistics on systems other than Linux
* libstatgrab may be used to collect statistics on systems other than Linux
- and/or Solaris. Note that CPU- and disk-statistics, while being provided by
- this library, are not supported in collectd right now..
+ and/or Solaris. Note that CPU- and disk-statistics, while being provided
+ by this library, are not supported in collectd right now..
<http://www.i-scream.org/libstatgrab/>
<http://www.i-scream.org/libstatgrab/>
- * libcurl (optional)
- If you want to use the `apache' plugin
+ * libupsclient/nut (optional)
+ For the `nut' plugin which queries nut's `upsd'.
+
+ * librt, libsocket, libkstat, libdevinfo
+ Various standard Solaris libraries which provide system functions.
* CoreFoundation.framework and IOKit.framework
* CoreFoundation.framework and IOKit.framework
- For copiling on darwin in general and the `apple_sensors' plugin in
+ For compiling on darwin in general and the `apple_sensors' plugin in
particular.
Author
particular.
Author