X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=3d2237ed977d96a26bff804a7d8ac26c262175ac;hb=12c1e32ec71ffd5d90af5df4b430fba04d91aed5;hp=98612dce1ebf1cab45188ca1a1062c04c1863a75;hpb=9070c743a258987674aefc2c24415c436a00f08e;p=collectd.git diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod index 98612dce..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. @@ -45,7 +45,7 @@ directory for the daemon. =item B I Loads the plugin I. There must be at least one such line or B -will be mostly useless. The names of the plugins are listed in L. +will be mostly useless. =item B I @@ -53,18 +53,41 @@ Sets where to write the PID file to. This file is overwritten when it exists and deleted when the program ist stopped. Some init-scripts might override this setting using the B<-P> commandline option. +=item B I + +Path to the plugins (shared objects) of collectd. + +=item B I + +Set the file that contains the data-set descriptions. + =item B I Configures the interval in which to query the read plugins. Obviously smaller values lead to a higher system load produces by collectd, while higher values lead to more coarse statistics. +=item B I + +Number of threads to start for reading plugins. The default value if B<5>, but +you may want to increase this if you have more than five plugins that take a +long time to read. Mostly those are plugin that do network-IO. Setting this to +a value higher than the number of plugins you've loaded is totally useless. + =back =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 @@ -80,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. @@ -105,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 @@ -126,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 @@ -157,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 @@ -183,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 @@ -203,8 +238,31 @@ at most B<16384> to prevent typos and dumb mistakes. =back +=head2 Plugin C + +Please make sure to read L before using this plugin. It +contains valuable information on when the executable is executed and the +output that is expected from it. + +=over 4 + +=item B I I + +Execute the executable I as user I. + +=back + =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 @@ -231,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 @@ -271,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 @@ -299,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 @@ -313,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 @@ -329,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 @@ -354,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> @@ -376,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 @@ -405,6 +488,38 @@ UDP-Port to connect to. Defaults to B<123>. =back +=head2 Plugin C + +=over 4 + +=item B IB<@>I[B<:>I] + +Add a UPS to collect data from. The format is identical to the one accepted by +L. + +=back + +=head2 Plugin C + +=over 4 + +=item B I + +Loads the Perl plugin I. This does basically the same as B would +do in a Perl program. + +=item B I + +Prepends IB<::> to all plugin names loaded after this option. This is +provided for convenience to keep plugin names short. + +=item B I + +Adds I to the B<@INC> array. This is the same as using the B<-IDir> +command line option or B in the source code. + +=back + =head2 Plugin C =over 4 @@ -438,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 @@ -474,6 +589,14 @@ one CDP by calculating: Bottom line is, set this no smaller than the width of you graphs in pixels. The default is 1200. +=item B I + +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. + +For more information on how RRA-sizes are calculated see B above. + =item B I Set the "XFiles Factor". The default is 0.1. If unsure, don't set this option. @@ -503,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 @@ -517,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. @@ -557,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