X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=3d2237ed977d96a26bff804a7d8ac26c262175ac;hb=12c1e32ec71ffd5d90af5df4b430fba04d91aed5;hp=5531a124d55a5f107539e3792aa68e80b50f111f;hpb=6021c01cc8bd05d8dfb0d25af35389eeb1737a80;p=collectd.git diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod index 5531a124..3d2237ed 100644 --- a/src/collectd.conf.pod +++ b/src/collectd.conf.pod @@ -25,10 +25,10 @@ controls which plugins to load. These plugins ultimately define collectd's behavior. The syntax of this config file is similar to the config file of the famos -B. Each line containes either a key-value-pair or a +B. Each line contains either a key-value-pair or a section-start or -end. Empty lines and everything after the hash-symbol `#' is ignored. Values are either string, enclosed in double-quotes, -(floating-point-)numbers or a boolean extression, i.Ee. either B or +(floating-point-)numbers or a boolean expression, i.Ee. either B or B. String containing of only alphanumeric characters and underscores do not need to be quoted. @@ -78,8 +78,16 @@ a value higher than the number of plugins you've loaded is totally useless. =head1 PLUGIN OPTIONS -Some Plugins may register own options. These options must be inclosed in a -C-Section. Which options exist depends on the plugin used: +Some Plugins may register own options. These options must be enclosed in a +C-Section. Which options exist depends on the plugin used. Some plugins +require external configuration, too. The C, for example, +required C to be configured in the webserver you're going to +collect data from. These plugins are listed below as well, even if they don't +require any configuration within collectd's configfile. + +A list of all plugins and a short summary for each plugin can be found in the +F file shipped with the sourcecode and hopefully binary packets as +well. =head2 Plugin C @@ -95,7 +103,7 @@ the following snipped to base your Apache config upon: -Since it's C module is very similar to Apache's, B is +Since its C module is very similar to Apache's, B is also supported. It introduces a new field, called C, to count the number of currently connected clients. This field is also supported. @@ -120,7 +128,7 @@ Optional password needed for authentication. =item B I File that holds one or more SSL certificates. If you want to use HTTPS you will -possibly need this option. What CA certificates come bundeled with C +possibly need this option. What CA certificates come bundled with C and are checked by default depends on the distribution you use. =back @@ -141,6 +149,14 @@ TCP-Port to connect to. Defaults to B<3551>. =back +=head2 Plugin C + +This plugin doesn't have any options. It reads +F (for the first CPU +installed) to get the current CPU frequency. If this file does not exist make +sure B (L) or a similar tool is +installed and an "cpu governor" (that's a kernel module) is loaded. + =head2 Plugin C =over 4 @@ -172,7 +188,7 @@ Select partitions based on the filesystem type. Invert the selection: If set to true, all partitions B the ones that match any one of the criteria are collected. By default only selected -partitions are collected if a selection is made. If no selection is conifured +partitions are collected if a selection is made. If no selection is configured at all, B partitions are selected. =back @@ -198,6 +214,10 @@ Ignore packets that originate from this address. =over 4 +=item B I + +Sets the socket-file which is to be created. + =item B I If running as root change the group of the UNIX-socket after it has been @@ -221,7 +241,7 @@ at most B<16384> to prevent typos and dumb mistakes. =head2 Plugin C Please make sure to read L before using this plugin. It -contains valueable information on when the executable is executed and the +contains valuable information on when the executable is executed and the output that is expected from it. =over 4 @@ -234,6 +254,15 @@ Execute the executable I as user I. =head2 Plugin C +To get values from B collectd connects to B (127.0.0.1), +port B<7634/tcp>. The B and B options can be used to change these +default values, see below. C has to be running to work correctly. If +C is not running timeouts may appear which may interfere with other +statistics.. + +The B homepage can be found at +L. + =over 4 =item B I @@ -260,7 +289,7 @@ a more detailed description see B below. If no configuration if given, the B-plugin will collect data from all interfaces. This may not be practical, especially for loopback- and similar interfaces. Thus, you can use the B-option to pick the -interfaces you're interested in. Sometimes, however, it's easier/prefered +interfaces you're interested in. Sometimes, however, it's easier/preferred to collect all interfaces I a few ones. This option enables you to do that: By setting B to I the effect of B is inversed: All selected interfaces are ignored and all @@ -300,11 +329,11 @@ detailed description see B below. If no configuration if given, the B-plugin will collect data from all irqs. This may not be practical, especially if no interrupts happen. Thus, you -can use the B-option to pick the interupt you're interested in. -Sometimes, however, it's easier/prefered to collect all interupts I a +can use the B-option to pick the interrupt you're interested in. +Sometimes, however, it's easier/preferred to collect all interrupts I a few ones. This option enables you to do that: By setting B to -I the effect of B is inversed: All selected interupts are ignored -and all other interupts are collected. +I the effect of B is inversed: All selected interrupts are ignored +and all other interrupts are collected. =back @@ -328,6 +357,17 @@ running in foreground- or non-daemon-mode. =head2 Plugin C +The C uses mbmon to retrieve temperature, voltage, etc. + +Be default collectd connects to B (127.0.0.1), port B<411/tcp>. The +B and B options can be used to change these values, see below. +C has to be running to work correctly. If C is not running +timeouts may appear which may interfere with other statistics.. + +C must be run with the -r option ("print TAG and Value format"); +Debian's F script already does this, other people +will need to ensure that this is the case. + =over 4 =item B I @@ -342,6 +382,20 @@ TCP-Port to connect to. Defaults to B<411>. =head2 Plugin C +The C requires B 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 +plugin logs loud complaints in case anything goes wrong. + +This plugin issues C and evaluates C, +C and C which correspond to F, +F and F. Also, the values of +C are put in F and values of C are put +in F. Please refer to the B, +I<5.2.4. Server Status Variables> for an explanation of these values. + +Use the following options to configure the plugin: + =over 4 =item B I @@ -358,7 +412,7 @@ Password needed to log into the database. =item B I -Select this database. Defaults to I which is a perfecly reasonable +Select this database. Defaults to I which is a perfectly reasonable option for what this plugin does. =back @@ -383,13 +437,13 @@ the argument is a multicast address the daemon will join that multicast group. If no B statement is found the server tries join both, the default IPv6 multicast group and the default IPv4 multicast group. If no B statement is found the client will try to send data to the IPv6 multicast group first. If -that failes the client will try the IPv4 multicast group. +that fails the client will try the IPv4 multicast group. The default IPv6 multicast group is C. The default IPv4 multicast group is C<239.192.74.66>. The optional I argument sets the port to use. It can either be given -using a numeric port number or a service name. If the argument is omited the +using a numeric port number or a service name. If the argument is omitted the default port B<25826> is assumed. =item B I<1-255> @@ -405,7 +459,7 @@ If set to I, write packets that were received via the network plugin to the sending sockets. This should only be activated when the B- and B-statements differ. Otherwise packets may be send multiple times to the same multicast group. While this results in more network traffic than -neccessary it's not a huge problem since the plugin has a duplicate detection, +necessary it's not a huge problem since the plugin has a duplicate detection, so the values will not loop. =item B I @@ -499,13 +553,13 @@ and minor and major pagefaults. You can use the settings B, B, B, and B to finetune your RRD-files. Please read L if you encounter problems using these settings. If you don't want to dive into the depths of RRDTool, you -can savely ignore these settings. +can safely ignore these settings. =over 4 =item B I -Set the directory to store CSV-files under. Per default CSV-files are generated +Set the directory to store RRD-files under. Per default RRD-files are generated beneath the daemon's working directory, i.Ee. the B. =item B I @@ -537,7 +591,7 @@ default is 1200. =item B I -Adds an RRA-timespan, given in seconds. Use this option mulitple times to have +Adds an RRA-timespan, given in seconds. Use this option multiple times to have more then one RRA. If this option is never used, the built-in default of (3600, 86400, 604800, 2678400, 31622400) is used. @@ -572,6 +626,14 @@ used. =head2 Plugin C +The C uses B to retrieve sensor-values. This means +that all the needed modules have to be loaded and lm_sensors has to be +configured (most likely by editing F. Read +L for details. + +The B homepage can be found at +L. + =over 4 =item B I @@ -586,7 +648,7 @@ voltage sensor I of the I on the isa bus at the address 0290. If no configuration if given, the B-plugin will collect data from all sensors. This may not be practical, especially for uninteresting sensors. Thus, you can use the B-option to pick the sensors you're interested -in. Sometimes, however, it's easier/prefered to collect all sensors I a +in. Sometimes, however, it's easier/preferred to collect all sensors I a few ones. This option enables you to do that: By setting B to I the effect of B is inversed: All selected sensors are ignored and all other sensors are collected. @@ -626,9 +688,26 @@ L. Defaults to B<0770>. =back +=head2 Plugin C + +This plugin doesn't have any options. B support is only available for +Linux. It cannot yet be found in a vanilla kernel, though. To make use of this +plugin you need a kernel that has B support built in, i.Ee. you +need to apply the patches and compile your own kernel, which will then provide +the F filesystem that is required by this plugin. + +The B homepage can be found at L. + =head1 SEE ALSO -L +L, +L, +L, +L, +L, +L, +L, +L =head1 AUTHOR