X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=7a6418954e39e19688f277e6a6be6f95d581fcae;hb=0a73779531039d715e8ca405658c65ba03fad408;hp=9030cffb723faf845e5d070aee1c8570289eb4b9;hpb=4a7c078d1df0241cd6ede811877a4259cc36932e;p=collectd.git diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod index 9030cffb..7a641895 100644 --- a/src/collectd.conf.pod +++ b/src/collectd.conf.pod @@ -870,19 +870,35 @@ Select partitions based on the mountpoint. Select partitions based on the filesystem type. -=item B I|I +=item B B|B 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 configured at all, B partitions are selected. -=item B I|I +=item B B|B Report using the device name rather than the mountpoint. i.e. with this I, (the default), it will report a disk as "root", but with it I, it will be "sda1" (or whichever). +=item B B|B + +When enabled, the blocks reserved for root are reported separately. When +disabled (the default for backwards compatibility reasons) the reserved space +will be included in the "free" space. + +When disabled, the "df" type will be used to store "free" and "used" space. The +mount point or disk name (see option B) is used as type +instance in this case (again: backwards compatibility). + +When enabled, the type "df_complex" is used and three files are created. The +mount point or disk name is used as plugin instance and the type instance is +set to "free", "reserved" and "used" as appropriate. + +Enabling this option is recommended. + =back =head2 Plugin C @@ -1667,8 +1683,7 @@ Required capabilities are documented below. User "username" Password "aef4Aebe" Interval 30 - - + Interval 30 GetNameCache true @@ -1676,14 +1691,39 @@ Required capabilities are documented below. GetBufferCache true GetInodeCache true + Interval 30 GetBusy true - - - - + + + Interval 30 + GetIO "volume0" + IgnoreSelectedIO false + GetOps "volume0" + IgnoreSelectedOps false + GetLatency "volume0" + IgnoreSelectedLatency false + + + + Interval 30 + GetCapacity "vol0" + GetCapacity "vol1" + IgnoreSelectedCapacity false + GetSnapshot "vol1" + GetSnapshot "vol3" + IgnoreSelectedSnapshot false + + + + Interval 30 + GetCPULoad true + GetInterfaces true + GetDiskOps true + GetDiskIO true + @@ -1753,20 +1793,14 @@ The following options are valid inside all blocks: =over 4 -=item B I - -The host specific interval between data collections is multiplied by this value -for collecting these data. - -Optional - -Type: integer +=item B I -Default: 1 +Collect the respective statistics every I seconds. Defaults to the +host specific setting. =back -=head3 The GetSystemPerfData block +=head3 The System block This will collect various performance data about the whole system. @@ -1775,6 +1809,10 @@ B To get this data the collectd user needs the =over 4 +=item B I + +Collect disk statistics every I seconds. + =item B B|B If you set this option to true the current CPU usage will be read. This will be @@ -1946,80 +1984,78 @@ Result: One value list of type "percent" and type instance "disk_busy". =back -=head3 The GetVolumePerfData block +=head3 The VolumePerf block This will collect various performance data about the individual volumes. -All of these options take a list of volumes as parameters. In this case -"volume" means just the name of the volume, without the "/vol/" prefix or -anything like that. - -The special values "-" and "+" are supported. "-" means "don't collect values -for any volumes". "+" means "collect values for all volumes, even volumes that -are created after collectd was started." Additionally you can prefix a volume -name with a "-" sign to exclude this one volume. Eg '"+" "-vol0"' collectes -values for all volumes except vol0. The order of the parameters is important. -'"-vol0" "+"' doesn't make sense because the "+" overrides the earlier "-vol0". +You can select which data to collect about which volume using the following +options. They follow the standard ignorelist semantic. B To get this data the collectd user needs the -"api-perf-object-get-instances" capability. +I capability. =over 4 -=item B I [I ...] -The current IO throughput will be read for every volume specified here. +=item B I -Optional +Collect volume performance data every I seconds. -Type: list of strings +=item B I -Default: "+" +=item B I -Result: Data sources of type "disk_octets" and the name of the volume as -plugin_instance. +=item B I -=item B I [I ...] +Select the given volume for IO, operations or latency statistics collection. +The argument is the name of the volume without the C prefix. -The current number of operation will be read for every volume specified here. +Since the standard ignorelist functionality is used here, you can use a string +starting and ending with a slash to specify regular expression matching: To +match the volumes "vol0", "vol2" and "vol7", you can use this regular +expression: -Optional + GetIO "/^vol[027]$/" -Type: list of strings +If no regular expression is specified, an exact match is required. Both, +regular and exact matching are case sensitive. -Default: "+" +If no volume was specified at all for either of the three options, that data +will be collected for all available volumes. -Result: Data sources of type "disk_ops" and the name of the volume as -plugin_instance. +=item B B|B -=item B I [I ...] +=item B B|B -The current latency for volume access in microseconds will be read for every -volume specified here. +=item B B|B -Optional +When set to B, the volumes selected for IO, operations or latency +statistics collection will be ignored and the data will be collected for all +other volumes. -Type: list of strings +When set to B, data will only be collected for the specified volumes and +all other volumes will be ignored. -Default: "+" +If no volumes have been specified with the above B options, all volumes +will be collected regardless of the B option. -Result: Data sources of type "disk_latency" and the name of the volume as -plugin_instance. +Defaults to B =back -=head3 The GetVolumeData block +=head3 The VolumeUsage block This will collect capacity data about the individual volumes. -All of these options take a list of volumes as parameters, just like the -GetVolumePerfData options. - -B To get this data the collectd user needs the "api-volume-list-info" +B To get this data the collectd user needs the I capability. =over 4 -=item B +=item B I + +Collect volume usage statistics every I seconds. + +=item B I The current capacity of the volume will be collected. This will result in two to four value lists, depending on the configuration of the volume. All data @@ -2037,15 +2073,38 @@ reported as a 32Ebit number. This plugin tries to guess the correct number which works most of the time. If you see strange values here, bug NetApp support to fix this. -Optional +Repeat this option to specify multiple volumes. -Type: list of strings +=item B B|B -Default: "+" +Specify whether to collect only the volumes selected by the B +option or to ignore those volumes. B defaults to +B. However, if no B option is specified at all, all +capacities will be selected anyway. -=item B +=item B I -B +Select volumes from which to collect snapshot information. + +Usually, the space used for snapshots is included in the space reported as +"used". If snapshot information is collected as well, the space used for +snapshots is subtracted from the used space. + +To make things even more interesting, it is possible to reserve space to be +used for snapshots. If the space required for snapshots is less than that +reserved space, there is "reserved free" and "reserved used" space in addition +to "free" and "used". If the space required for snapshots exceeds the reserved +space, that part allocated in the normal space is subtracted from the "used" +space again. + +Repeat this option to specify multiple volumes. + +=item B + +Specify whether to collect only the volumes selected by the B +option or to ignore those volumes. B defaults to +B. However, if no B option is specified at all, all +capacities will be selected anyway. =back