X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=9c97137ce8b9121f0536efb3cef1d335aafac189;hb=2079ee1517e34de372f58e7e2267ad5c71a8a41f;hp=1e564cf4b85e50bdbd6987f84fb4dfc69db91549;hpb=da62514318db2acc388403c92dc3cbfabec919bb;p=collectd.git diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod index 1e564cf4..9c97137c 100644 --- a/src/collectd.conf.pod +++ b/src/collectd.conf.pod @@ -241,6 +241,12 @@ Path to the plugins (shared objects) of collectd. Set one or more files that contain the data-set descriptions. See L for a description of the format of this file. +If this option is not specified, a default file is read. If you need to define +custom types in addition to the types defined in the default file, you need to +explicitly load both. In other words, if the B option is encountered +the default behavior is disabled and if you need the default types you have to +also explicitly load them. + =item B I Configures the interval in which to query the read plugins. Obviously smaller @@ -954,7 +960,7 @@ support the SM Bus command subset). The reduction or normalization to mean sea level pressure requires (depending on selected method/approximation) also altitude and reference to temperature -sensor(s). When multiple temperature sensors are configured the minumum of +sensor(s). When multiple temperature sensors are configured the minimum of their values is always used (expecting that the warmer ones are affected by e.g. direct sun light at that moment). @@ -1066,7 +1072,7 @@ The altitude (in meters) of the location where you meassure the pressure. Temperature sensor(s) which should be used as a reference when normalizing the pressure using C method 2. -When specified more sensors a minumum is found and used each time. The +When specified more sensors a minimum is found and used each time. The temperature reading directly from this pressure sensor/plugin is typically not suitable as the pressure sensor will be probably inside while we want outside temperature. The collectd reference name is something like @@ -1447,6 +1453,11 @@ are set to B. In this case, by default, metrics will be reported as Jiffies. By setting this option to B, you can request percentage values in the un-aggregated (per-CPU, per-state) mode as well. +=item B B|B + +When set to B, reports the number of available CPUs. +Defaults to B. + =back =head2 Plugin C @@ -1457,6 +1468,16 @@ 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 + +This plugin doesn't have any options. It reads CLOCK_BOOTTIME and +CLOCK_MONOTONIC and reports the difference between these clocks. Since +BOOTTIME clock increments while device is suspended and MONOTONIC +clock does not, the derivative of the difference between these clocks +gives the relative amount of time the device has spent in suspend +state. The recorded value is in milliseconds of sleep per seconds of +wall clock. + =head2 Plugin C =over 4 @@ -1760,6 +1781,11 @@ The following options are valid within B blocks: =over 4 +=item B I + +Use I as the host name when submitting values. Defaults to the global +host name setting. + =item B I Sets the plugin instance to I. @@ -2196,7 +2222,7 @@ is passed to them, so invalid settings here may go unnoticed. This is not the plugin's fault, it will report errors if it gets them from the libraryE/ the driver. If a driver complains about an option, the plugin will dump a complete list of all options understood by that driver to the log. There is no -way to programatically find out if an option expects a string or a numeric +way to programmatically find out if an option expects a string or a numeric argument, so you will have to refer to the appropriate DBD's documentation to find this out. Sorry. @@ -2631,6 +2657,78 @@ source, this is optional. Otherwise the option is required. =back +=head2 Plugin C + +The C connects to gpsd on the host machine. +The host, port, timeout and pause are configurable. + +This is useful if you run an NTP server using a GPS for source and you want to +monitor it. + +Mind your GPS must send $--GSA for having the data reported! + +The following elements are collected: + +=over 4 + +=item B + +Number of satellites used for fix (type instance "used") and in view (type +instance "visible"). 0 means no GPS satellites are visible. + +=item B + +Vertical and horizontal dilution (type instance "horizontal" or "vertical"). +It should be between 0 and 3. +Look at the documentation of your GPS to know more. + +=back + +Synopsis: + + LoadPlugin gps + + # Connect to localhost on gpsd regular port: + Host "127.0.0.1" + Port "2947" + # 15 ms timeout + Timeout 0.015 + # PauseConnect of 5 sec. between connection attempts. + PauseConnect 5 + + +Available configuration options: + +=over 4 + +=item B I + +The host on which gpsd daemon runs. Defaults to B. + +=item B I + +Port to connect to gpsd on the host machine. Defaults to B<2947>. + +=item B I + +Timeout in seconds (default 0.015 sec). + +The GPS data stream is fetch by the plugin form the daemon. +It waits for data to be available, if none arrives it times out +and loop for another reading. +Mind to put a low value gpsd expects value in the micro-seconds area +(recommended is 500 us) since the waiting function is blocking. +Value must be between 500 us and 5 sec., if outside that range the +default value is applied. + +This only applies from gpsd release-2.95. + +=item B I + +Pause to apply between attempts of connection to gpsd in seconds (default 5 sec). + +=back + =head2 Plugin C The I plugin provides an RPC interface to submit values to or query @@ -2641,6 +2739,33 @@ The B homepage can be found at L. =over 4 +=item B I I + +The B statement sets the address of a server to which to send metrics +via the C function. + +The argument I may be a hostname, an IPv4 address, or an IPv6 address. + +Optionally, B may be specified as a configuration block which supports +the following options: + +=over 4 + +=item B B|B + +Whether to require SSL for outgoing connections. Default: false. + +=item B I + +=item B I + +=item B I + +Filenames specifying SSL certificate and key material to be used with SSL +connections. + +=back + =item B I I The B statement sets the network address to bind to. When multiple @@ -2658,22 +2783,17 @@ supports the following options: Whether to enable SSL for incoming connections. Default: false. -=item B I +=item B I -=item B I +=item B I -=item B I +=item B I Filenames specifying SSL certificate and key material to be used with SSL connections. =back -=item B I - -Number of threads to start for handling incoming connections. The default -value is B<5>. - =back =head2 Plugin C @@ -3001,6 +3121,12 @@ Defaults to false. =back +=head2 Plugin C + +This plugin embeds a Lua interpreter into collectd and provides an interface +to collectd's plugin system. See L for its documentation. + + =head2 Plugin C The C uses mbmon to retrieve temperature, voltage, etc. @@ -3652,6 +3778,11 @@ Synopsis: Port "3306" MasterStats true ConnectTimeout 10 + SSLKey "/path/to/key.pem" + SSLCert "/path/to/cert.pem" + SSLCA "/path/to/ca.pem" + SSLCAPath "/path/to/cas/" + SSLCipher "DHE-RSA-AES256-SHA" @@ -3673,7 +3804,8 @@ Synopsis: A B block defines one connection to a MySQL database. It accepts a single argument which specifies the name of the database. None of the other options are required. MySQL will use default values as documented in the -section "mysql_real_connect()" in the B. +"mysql_real_connect()" and "mysql_ssl_set()" sections in the +B. =over 4 @@ -3748,6 +3880,26 @@ or SQL threads are not running. Defaults to B. Sets the connect timeout for the MySQL client. +=item B I + +If provided, the X509 key in PEM format. + +=item B I + +If provided, the X509 cert in PEM format. + +=item B I + +If provided, the CA file in PEM format (check OpenSSL docs). + +=item B I + +If provided, the CA directory (check OpenSSL docs). + +=item B I + +If provided, the SSL cipher to use. + =back =head2 Plugin C @@ -5633,7 +5785,7 @@ transaction fails or if the database server crashes. Specify the plugin instance name that should be used instead of the database name (which is the default, if this option has not been specified). This -allows to query multiple databases of the same name on the same host (e.g. +allows one to query multiple databases of the same name on the same host (e.g. when running multiple database server versions in parallel). The plugin instance name can also be set from the query result using the B option in B block. @@ -5696,7 +5848,7 @@ Use SSL only. Specify the plugin instance name that should be used instead of the database name (which is the default, if this option has not been specified). This -allows to query multiple databases of the same name on the same host (e.g. +allows one to query multiple databases of the same name on the same host (e.g. when running multiple database server versions in parallel). =item B I @@ -5896,11 +6048,11 @@ below this limit. =item B I I -Similar to the B option this allows to select more detailed +Similar to the B option this allows one to select more detailed statistics of processes matching the specified I (see L for details). The statistics of all matching processes are summed up and dispatched to the daemon using the specified I as an identifier. This -allows to "group" several processes together. I must not contain +allows one to "group" several processes together. I must not contain slashes. =item B I @@ -6115,8 +6267,8 @@ C anymore, it does not need to be flushed when C is to be restarted. This results in much shorter (if any) gaps in graphs, especially under heavy load. Also, the C command line utility is aware of the daemon so that it can flush values to disk automatically when needed. This -allows to integrate automated flushing of values into graphing solutions much -more easily. +allows one to integrate automated flushing of values into graphing solutions +much more easily. There are disadvantages, though: The daemon may reside on a different host, so it may not be possible for C to create the appropriate RRD files @@ -7924,7 +8076,7 @@ forwarded to the kafka producer library B. =item B I -Use the specified string as a partioning key for the topic. Kafka breaks +Use the specified string as a partitioning key for the topic. Kafka breaks topic into partitions and guarantees that for a given topology, the same consumer will be used for a specific key. The special (case insensitive) string B can be used to specify that an arbitrary partition should @@ -9238,7 +9390,7 @@ Available options: =item B I -=item B I I +=item B I I Set the appropriate field to the given string. The strings for plugin instance and type instance may be empty, the strings for host and plugin may not be