diff --git a/src/collectd.pod b/src/collectd.pod
index 4df62fa09a6ffd4aa0d8726ae05777f6a91323cd..d926017bbb6d1cbdae48793587d52c3bd46e9f44 100644 (file)
--- a/src/collectd.pod
+++ b/src/collectd.pod
=item
+Mountpoint usage (I<df>)
+
+=item
+
Disk and partition usage/throughput (I<disk>)
=item
=item
+MySQL statistics (I<mysql>)
+
+=item
+
NFS utilization (I<nfs>, Linux only)
=item
=over 4
-=item B<-l>
-
-Start in local mode. This is the default. No data will be sent or read to/from
-the network. Information will be read and written by the same process. See
-L<"MODES">.
+=item B<-C> I<E<lt>config-fileE<gt>>
-=item B<-c>
-
-Start in client (transmitter) mode. Data will be sent to the multicast group.
-See L<"MODES">.
-
-=item B<-s>
-
-Start in server (receiver) mode. Data sent to the multicast group will be read
-and stored in RRD files. See L<"MODES">.
+Specify an alternative config file. This is the place to go when you wish to
+change B<collectd>'s behavior. The path may be relative to the current working
+directory.
=item B<-f>
descriptors, detach from the session nor write a pid file. This is mainly
thought for 'supervisioning' init replacements such as I<runit>.
-=item B<-D> I<E<lt>directoryE<gt>>
-
-Sets the directory collectd should work in. All F<.rrd>-files are created in
-this directory. Per default this is F</var/lib/collectd/>.
-
-=item B<-M> I<E<lt>directoryE<gt>>
-
-Sets the directory collectd should look for plugins in. Per default this is
-F</usr/lib/collectd>.
-
-=item B<-P> I<E<lt>fileE<gt>>
-
-Sets the PID-file.
-
=item B<-h>
Output usage information and exit.
-=item B<-p> I<E<lt>hostE<gt>>
-
-Sets the host to ping periodically. This option may be given more than once to
-ping multiple hosts. If this option is not given at least once no host will be
-pinged.
-
=back
=head1 RRD FILES
DS:idle:COUNTER:25:0:100
DS:wait:COUNTER:25:0:100
+=item Mountpoints (F<df-I<E<lt>pathE<gt>>.rrd>)
+
+ DS:used:GAUGE:25:0:U
+ DS:free:GAUGE:25:0:U
+
=item Diskstats (F<disk-I<E<lt>majorE<gt>>-I<E<lt>minorE<gt>>.rrd>)
DS:rcount:COUNTER:25:0:U
DS:buffers:GAUGE:25:0:9223372036854775807
DS:cached:GAUGE:25:0:9223372036854775807
+=item MySQL statistics (F<mysql_commands-I<E<lt>commandE<gt>>.rrd> and F<mysql_handler-I<E<lt>handlerE<gt>>.rrd>)
+
+ DS:value:COUNTER:25:0:U
+
=item NFSv2 Procedures (F<nfs2_procedures-I<(client|server)>.rrd>)
DS:null:COUNTER:25:0:U
(B<224.0.0.0/4>) if multicast packages take the wrong interface. The listener
on the other hand listens on B<all> interfaces.
-=head1 SPECIAL MODULES
+=head1 SPECIAL PLUGINS
=head2 cpufreq
not exist make sure B<cpufreqd> (L<http://cpufreqd.sourceforge.net/>) or a
similar tool is installed.
+=head2 mysql
+
+Requires B<mysqlclient> to be installed. It connects to the database when
+started and keeps the connection up as long as possible. When the connection is
+interrupted for whatever reason it will try to re-connect. The syslog will
+contain loud complaints in case anything goes wrong.
+
+This plugin issues C<SHOW STATUS> and evaluates C<Bytes_{received,sent}>,
+C<Com_*> and C<Handler_*> which correspond to F<traffic-mysql.rrd>,
+F<mysql_commands-*.rrd> and F<mysql_handler-*.rrd>. Please refer to the B<MySQL
+reference manual>, I<5.2.4. Server Status Variables> for an explanation of
+these values.
+
=head2 sensors
The B<sensors> module uses lm_sensors to retrieve sensor-values. This means