X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=3e11e0637cd57b480301e93a8af863f7c85dc3f9;hb=2633870ff70e8930c3e637970e775a6265ab26f0;hp=3f3dc9e3829eb9cd3be8c38388d49f8276f5cdeb;hpb=c6557cb8950f50a41a1decfb34439b060e2fd371;p=collectd.git diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod index 3f3dc9e3..3e11e063 100644 --- a/src/collectd.conf.pod +++ b/src/collectd.conf.pod @@ -404,13 +404,13 @@ There are a couple of limitations you should be aware of: =over 4 -=item +=item * The I cannot be left unspecified, because it is not reasonable to add apples to oranges. Also, the internal lookup structure won't work if you try to group by type. -=item +=item * There must be at least one unspecified, ungrouped field. Otherwise nothing will be aggregated. @@ -485,19 +485,19 @@ This will create the files: =over 4 -=item +=item * foo.example.com/cpu-even-average/cpu-idle -=item +=item * foo.example.com/cpu-even-average/cpu-system -=item +=item * foo.example.com/cpu-even-average/cpu-user -=item +=item * ... @@ -1361,6 +1361,32 @@ at all, B cgroups are selected. =back +=head2 Plugin C + +The C plugin collects ntp data from a B server, such as clock +skew and per-peer stratum. + +For talking to B, it mimics what the B control program does +on the wire. + +Available configuration options for the C plugin: + +=over 4 + +=item B I + +Hostname of the host running B. Defaults to B. + +=item B I + +UDP-Port to connect to. Defaults to B<323>. + +=item B I + +Connection timeout in seconds. Defaults to B<2>. + +=back + =head2 Plugin C This plugin collects IP conntrack statistics. @@ -1381,11 +1407,11 @@ as Jiffies, using the C type. Two aggregations are available: =over 4 -=item +=item * Sum, per-state, over all CPUs installed in the system; and -=item +=item * Sum, per-CPU, over all non-idle states of a CPU, creating an "active" state. @@ -1451,6 +1477,92 @@ number. =back +=head2 cURL Statistics + +All cURL-based plugins support collection of generic, request-based +statistics. These are disabled by default and can be enabled selectively for +each page or URL queried from the curl, curl_json, or curl_xml plugins. See +the documentation of those plugins for specific information. This section +describes the available metrics that can be configured for each plugin. All +options are disabled by default. + +See L for more details. + +=over 4 + +=item B B + +Total time of the transfer, including name resolving, TCP connect, etc. + +=item B B + +Time it took from the start until name resolving was completed. + +=item B B + +Time it took from the start until the connect to the remote host (or proxy) +was completed. + +=item B B + +Time it took from the start until the SSL/SSH connect/handshake to the remote +host was completed. + +=item B B + +Time it took from the start until just before the transfer begins. + +=item B B + +Time it took from the start until the first byte was received. + +=item B B + +Time it took for all redirection steps include name lookup, connect, +pre-transfer and transfer before final transaction was started. + +=item B B + +The total number of redirections that were actually followed. + +=item B B + +The total amount of bytes that were uploaded. + +=item B B + +The total amount of bytes that were downloaded. + +=item B B + +The average download speed that curl measured for the complete download. + +=item B B + +The average upload speed that curl measured for the complete upload. + +=item B B + +The total size of all the headers received. + +=item B B + +The total size of the issued requests. + +=item B B + +The content-length of the download. + +=item B B + +The specified size of the upload. + +=item B B + +The number of new connections that were created to achieve the transfer. + +=back + =head2 Plugin C The curl plugin uses the B (L) to read web pages @@ -1551,11 +1663,21 @@ Beware that requests will get aborted if they take too long to complete. Adjust B accordingly if you expect B to report such slow requests. +This option is similar to enabling the B statistic but it's +measured by collectd instead of cURL. + =item B B|B Measure response code for the request. If this setting is enabled, B blocks (see below) are optional. Disabled by default. +=item BStatisticsE> + +One B block can be used to specify cURL statistics to be collected +for each request to the remote web site. See the section "cURL Statistics" +above for details. If this setting is enabled, B blocks (see below) are +optional. + =item BMatchE> One or more B blocks that define how to match information in the data @@ -1668,6 +1790,12 @@ URL. By default the global B setting will be used. These options behave exactly equivalent to the appropriate options of the I plugin. Please see there for a detailed description. +=item BStatisticsE> + +One B block can be used to specify cURL statistics to be collected +for each request to the remote URL. See the section "cURL Statistics" above +for details. + =back The following options are valid within B blocks: @@ -1770,6 +1898,12 @@ Examples: These options behave exactly equivalent to the appropriate options of the I. Please see there for a detailed description. +=item BStatisticsE> + +One B block can be used to specify cURL statistics to be collected +for each request to the remote URL. See the section "cURL Statistics" above +for details. + =item EB IE Within each B block, there must be one or more B blocks. Each @@ -2500,7 +2634,7 @@ source, this is optional. Otherwise the option is required. =head2 Plugin C The I plugin provides an RPC interface to submit values to or query -values from collectd based on the open source gRPC framework. It exposes and +values from collectd based on the open source gRPC framework. It exposes an end-point for dispatching values to the daemon. The B homepage can be found at L. @@ -2510,7 +2644,7 @@ The B homepage can be found at L. =item B I I The B statement sets the network address to bind to. When multiple -statements are specified, the daemon will bin to all of them. If none are +statements are specified, the daemon will bind to all of them. If none are specified, it defaults to B<0.0.0.0:50051>. The argument I may be a hostname, an IPv4 address, or an IPv6 address. @@ -2601,6 +2735,18 @@ This will ignore the loopback interface, all interfaces with names starting with I and all interfaces with names starting with I followed by at least one digit. +=item B I|I + +When set to I, only interfaces with non-zero traffic will be +reported. Note that the check is done by looking into whether a +package was sent at any time from boot and the corresponding counter +is non-zero. So, if the interface has been sending data in the past +since boot, but not during the reported time-interval, it will still +be reported. + +The default value is I and results in collection of the data +from all interfaces that are selected by B and +B options. =item B I|I @@ -3515,6 +3661,13 @@ Synopsis: SlaveStats true SlaveNotifications true + + + Alias "galera" + Host "localhost" + Socket "/var/run/mysql/mysqld.sock" + WsrepStats true + A B block defines one connection to a MySQL database. It accepts a @@ -3585,6 +3738,12 @@ privileges. See the B documentation above. Defaults to B. If enabled, the plugin sends a notification if the replication slave I/O and / or SQL threads are not running. Defaults to B. +=item B I + + Enable the collection of wsrep plugin statistics, used in Master-Master + replication setups like in MySQL Galera/Percona XtraDB Cluster. + User needs only privileges to execute 'SHOW GLOBAL STATUS' + =item B I Sets the connect timeout for the MySQL client. @@ -4545,11 +4704,11 @@ Sets the I to write to. Defaults to F -The C plugin collects per-peer ntpd data such as time offset and time +The C plugin collects per-peer ntp data such as time offset and time dispersion. For talking to B, it mimics what the B control program does on -wire - using B specific requests. This mode is deprecated with +the wire - using B specific requests. This mode is deprecated with newer B releases (4.2.7p230 and later). For the C plugin to work correctly with them, the ntp daemon must be explicitly configured to enable B (which is disabled by default). Refer to the I @@ -6322,6 +6481,22 @@ collected. If at least one B option is given and no B or set to B, B matching disks will be collected. If B is set to B, all disks are collected B the ones matched. +=item B B|B + +Normally, the C plugin will ignore disks that are reported to be asleep. +This option disables the sleep mode check and allows the plugin to collect data +from these disks anyway. This is useful in cases where libatasmart mistakenly +reports disks as asleep because it has not been updated to incorporate support +for newer idle states in the ATA spec. + +=item B B|B + +A disk's kernel name (e.g., sda) can change from one boot to the next. If this +option is enabled, the C plugin will use the disk's serial number (e.g., +HGST_HUH728080ALE600_2EJ8VH8X) instead of the kernel name as the key for +storing data. This ensures that the data for a given disk will be kept together +even if the kernel name changes. + =back =head2 Plugin C @@ -7059,20 +7234,20 @@ The following methods are used to find the machine's UUID, in order: =over 4 -=item +=item * Check I (or I). -=item +=item * Check for UUID from HAL (L) if present. -=item +=item * Check for UUID from C / SMBIOS. -=item +=item * Check for UUID from Xen hypervisor. @@ -7659,11 +7834,12 @@ Define which SSL protocol version must be used. By default C will attempt to figure out the remote SSL protocol version. See L for more details. -=item B B|B +=item B B|B|B Format of the output to generate. If set to B, will create output that is understood by the I and I plugins. When set to B, will -create output in the I (JSON). +create output in the I (JSON). When set to KAIROSDB +, will create output in the KairosDB format. Defaults to B.