Merge pull request #2874 from elfiesmelfie/feat_virt_block_info

[collectd.git] / src / collectd.conf.pod

diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index 3c1efec..890a4e0 100644 (file)
--- a/src/collectd.conf.pod
+++ b/src/collectd.conf.pod
@@ -8397,26 +8397,26 @@ Sets how the values are cumulated. I<Type> is one of:
 
 =item B<GaugeAverage>
 
 
 =item B<GaugeAverage>
 

-Calculate the average.
+Calculate the average of all values matched during the interval.

 
 =item B<GaugeMin>
 
 
 =item B<GaugeMin>
 

-Use the smallest number only.
+Report the smallest value matched during the interval.

 
 =item B<GaugeMax>
 
 
 =item B<GaugeMax>
 

-Use the greatest number only.
+Report the greatest value matched during the interval.

 
 =item B<GaugeLast>
 
 
 =item B<GaugeLast>
 

-Use the last number found.
+Report the last value matched during the interval.

 
 =item B<GaugePersist>
 
 
 =item B<GaugePersist>
 

-Use the last number found. The number is not reset at the end of an interval.
-It is continously reported until another number is matched. This is intended
-for cases in which only state changes are reported, for example a thermometer
-that only reports the temperature when it changes.
+Report the last matching value. The metric is I<not> reset to C<NaN> at the end
+of an interval. It is continuously reported until another value is matched.
+This is intended for cases in which only state changes are reported, for
+example a thermometer that only reports the temperature when it changes.

 
 =item B<CounterSet>
 
 
 =item B<CounterSet>
 


@@ -8447,6 +8447,9 @@ Increase the internal counter by one. These B<DSType> are the only ones that do
 not use the matched subexpression, but simply count the number of matched
 lines. Thus, you may use a regular expression without submatch in this case.
 
 not use the matched subexpression, but simply count the number of matched
 lines. Thus, you may use a regular expression without submatch in this case.
 

+B<GaugeInc> is reset to I<zero> after every read, unlike other B<Gauge*>
+metrics which are reset to C<NaN>.
+

 =item B<Distribution>
 
 Type to do calculations based on the distribution of values, primarily
 =item B<Distribution>
 
 Type to do calculations based on the distribution of values, primarily


@@ -8520,8 +8523,12 @@ The B<Gauge*> and B<Distribution> types interpret the submatch as a floating
 point number, using L<strtod(3)>. The B<Counter*> and B<AbsoluteSet> types
 interpret the submatch as an unsigned integer using L<strtoull(3)>. The
 B<Derive*> types interpret the submatch as a signed integer using
 point number, using L<strtod(3)>. The B<Counter*> and B<AbsoluteSet> types
 interpret the submatch as an unsigned integer using L<strtoull(3)>. The
 B<Derive*> types interpret the submatch as a signed integer using

-L<strtoll(3)>. B<CounterInc> and B<DeriveInc> do not use the submatch at all
-and it may be omitted in this case.
+L<strtoll(3)>. B<CounterInc>, B<DeriveInc> and B<GaugeInc> do not use the
+submatch at all and it may be omitted in this case.
+
+The B<Gauge*> types, unless noted otherwise, are reset to C<NaN> after being
+reported. In other words, B<GaugeAverage> reports the average of all values
+matched since the last metric was reported (or C<NaN> if there was no match).

 
 =item B<Type> I<Type>
 
 
 =item B<Type> I<Type>
 


@@ -11589,7 +11596,7 @@ be an FQDN.
 =head1 IGNORELISTS
 
 B<Ignorelists> are a generic framework to either ignore some metrics or report
 =head1 IGNORELISTS
 
 B<Ignorelists> are a generic framework to either ignore some metrics or report

-specific metircs only. Plugins usually provide one or more options to specify
+specific metrics only. Plugins usually provide one or more options to specify

 the items (mounts points, devices, ...) and the boolean option
 C<IgnoreSelected>.
 
 the items (mounts points, devices, ...) and the boolean option
 C<IgnoreSelected>.