X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=a12a48b64d88701d245be3da5f48b9cccb194848;hb=56e1979ea2d1a373c614cd71c902435f46090da1;hp=9af1ff513d13ae3d98f020690b99ee7b36ca9b30;hpb=b317e0c149e5ea17fda320b02002920fe887a67c;p=collectd.git diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod index 9af1ff51..a12a48b6 100644 --- a/src/collectd.conf.pod +++ b/src/collectd.conf.pod @@ -112,7 +112,7 @@ a value higher than the number of plugins you've loaded is totally useless. =item B I Sets the hostname that identifies a host. If you omit this setting, the -hostname will be determinded using the L system call. +hostname will be determined using the L system call. =item B B @@ -443,7 +443,7 @@ The curl plugin uses the B (L) to read web pages and the match infrastructure (the same code used by the tail plugin) to use regular expressions with the received data. -The following example will read the current value of AMD stock from google's +The following example will read the current value of AMD stock from Google's finance page and dispatch the value to collectd. @@ -562,9 +562,9 @@ The following example will collect the status values from each database: In the B block, there may be one or more B blocks, each defining a URL to be fetched via HTTP (using libcurl) and one or more B blocks. -The B string argument must be in a path format, of which is used to collect -a value from a JSON map object. If a B path element is that of a I<*> wildcard, -the values for all keys will be collectd. +The B string argument must be in a path format, which is used to collect a +value from a JSON map object. If a path element of B is the +I<*>Ewildcard, the values for all keys will be collectd. The following options are valid within B blocks: @@ -619,6 +619,110 @@ Type-instance to use. Defaults to the current map key or current string array el =back +=head2 Plugin C + +The B uses B (L) and B +(L) to retrieve XML data via cURL. + + + + Host "my_host" + Instance "some_instance" + User "collectd" + Password "thaiNg0I" + VerifyPeer true + VerifyHost true + CACert "/path/to/ca.crt" + + + Type "magic_level" + #InstancePrefix "prefix-" + InstanceFrom "td[1]" + ValuesFrom "td[2]/span[@class=\"level\"]" + + + + +In the B block, there may be one or more B blocks, each defining a +URL to be fetched via HTTP (using libcurl). Within each B block there are +options which specify the connection parameters, for example authentication +information, and one or more B blocks. + +Each B block specifies how to get one type of information. The +string argument must be a valid XPath expression which returns a list +of "base elements". One value is dispatched for each "base element". The +I and values are looked up using further I expressions +that should be relative to the base element. + +Within the B block the following options are accepted: + +=over 4 + +=item B I + +Use I as the host name when submitting values. Defaults to the global +host name setting. + +=item B I + +Use I as the plugin instance when submitting values. Defaults to an +empty string (no plugin instance). + +=item B I +=item B I +=item B B|B +=item B B|B +=item B I + +These options behave exactly equivalent to the appropriate options of the +I and I plugins. Please see there for a detailed description. + +=item EB IE + +Within each B block, there must be one or more B blocks. Each +B block specifies how to get one type of information. The string +argument must be a valid XPath expression which returns a list of "base +elements". One value is dispatched for each "base element". + +Within the B block the following options are accepted: + +=over 4 + +=item B I + +Specifies the I used for submitting patches. This determines the number +of values that are required / expected and whether the strings are parsed as +signed or unsigned integer or as double values. See L for details. +This option is required. + +=item B I + +Prefix the I with I. The values are simply +concatenated together without any separator. +This option is optional. + +=item B I + +Specifies a XPath expression to use for determining the I. The +XPath expression must return exactly one element. The element's value is then +used as I, possibly prefixed with I (see above). + +This value is required. As a special exception, if the "base XPath expression" +(the argument to the B block) returns exactly one argument, then this +option may be omitted. + +=item B I [I ...] + +Specifies one or more XPath expression to use for reading the values. The +number of XPath expressions must match the number of data sources in the +I specified with B (see above). Each XPath expression must return +exactly one element. The element's value is then parsed as a number and used as +value for the appropriate value in the value list dispatched to the daemon. + +=back + +=back + =head2 Plugin C This plugin uses the B library (L) to @@ -669,7 +773,7 @@ The following is a complete list of options: Query blocks define I statements and how the returned data should be interpreted. They are identified by the name that is given in the opening line of the block. Thus the name needs to be unique. Other than that, the name is -not used in collectd. +not used in collectd. In each B block, there is one or more B blocks. B blocks define which column holds which value or instance information. You can use @@ -727,7 +831,7 @@ options to provide multiple queries with the same name but with a slightly different syntax. The plugin will use only those queries, where the specified minimum and maximum versions fit the version of the database in use. -The database version is determined by C, see the +The database version is determined by C, see the L for details. Basically, each part of the version is assumed to be in the range from B<00> to B<99> and all dots are removed. So version "4.1.2" becomes @@ -952,7 +1056,7 @@ is set to B, all disks are collected B the ones matched. =item B I -The dns plugin uses B to capture dns traffic and analyses it. This +The dns plugin uses B to capture dns traffic and analyzes it. This option sets the interface that should be used. If this option is not set, or set to "any", the plugin will try to get packets from B interfaces. This may not work on certain platforms, such as MacEOSEX. @@ -1479,6 +1583,11 @@ running in foreground- or non-daemon-mode. Prefix all lines printed by the current time. Defaults to B. +=item B B|B + +When enabled, all lines are prefixed by the severity of the log message, for +example "warning". Defaults to B. + =back B: There is no need to notify the daemon after moving or removing the @@ -1679,7 +1788,7 @@ or SQL threads are not running. =head2 Plugin C -The netapp plugin can collect various performance and capacity informations +The netapp plugin can collect various performance and capacity information from a NetApp filer using the NetApp API. Please note that NetApp has a wide line of products and a lot of different @@ -2203,7 +2312,7 @@ Here are some examples to help you understand the above text more easily: =item B -The behaviour is the same as with all other similar plugins: If nothing is +The behavior is the same as with all other similar plugins: If nothing is selected at all, everything is collected. If some things are selected using the options described above, only these statistics are collected. If you set B to B, this behavior is inverted, i.Ee. the @@ -2215,7 +2324,7 @@ specified statistics will not be collected. The Network plugin sends data to a remote instance of collectd, receives data from a remote instance, or both at the same time. Data which has been received -from the network is usually not transmitted again, but this can be actived, see +from the network is usually not transmitted again, but this can be activated, see the B option below. The default IPv6 multicast group is C. The default IPv4 @@ -2509,7 +2618,7 @@ UDP-Port to connect to. Defaults to B<123>. =item B B|B -Sets wether or not to perform reverse lookups on peers. Since the name or +Sets whether or not to perform reverse lookups on peers. Since the name or IP-address may be used in a filename it is recommended to disable reverse lookups. The default is to do reverse lookups to preserve backwards compatibility, though. @@ -2667,6 +2776,13 @@ Available options: Specifies the location of the status file. +=item B B|B + +When enabled, the filename of the status file will be used as plugin instance +and the client's "common name" will be used as type instance. This is required +when reading multiple status files. Enabling this option is recommended, but to +maintain backwards compatibility this option is disabled by default. + =item B B|B Sets whether or not statistics about the compression used by OpenVPN should be @@ -3341,6 +3457,8 @@ multiple routers: User "collectd" Password "secr3t" CollectInterface true + CollectCPULoad true + CollectMemory true Host "router1.example.com" @@ -3348,6 +3466,8 @@ multiple routers: Password "5ecret" CollectInterface true CollectRegistrationTable true + CollectDF true + CollectDisk true @@ -3385,6 +3505,29 @@ present on the device. Defaults to B. When set to B, information about wireless LAN connections will be collected. Defaults to B. +=item B B|B + +When set to B, information about the CPU usage will be collected. The +number is a dimensionless value where zero indicates no CPU usage at all. +Defaults to B. + +=item B B|B + +When enabled, the amount of used and free memory will be collected. How used +memory is calculated is unknown, for example whether or not caches are counted +as used space. +Defaults to B. + +=item B B|B + +When enabled, the amount of used and free disk space will be collected. +Defaults to B. + +=item B B|B + +When enabled, the number of sectors written and bad blocks will be collected. +Defaults to B. + =back =head2 Plugin C @@ -3936,7 +4079,7 @@ selection is configured at all, B devices are selected. =head2 Plugin C -The C connects to a TokyoTyrant server and collects a +The C connects to a TokyoTyrant server and collects a couple metrics: number of records, and database size on disk. =over 4 @@ -4106,6 +4249,12 @@ create output in the I (JSON). Defaults to B. +=item B B + +If set to B, convert counter values to rates. If set to B (the +default) counter values are stored as is, i.Ee. as an increasing integer +number. + =back =head1 THRESHOLD CONFIGURATION @@ -4504,7 +4653,7 @@ This is the same as writing: =back -=head2 Built-in targets +=head2 Built-in targets The following targets are built into the core daemon and therefore need no plugins to be loaded: