Match:Empty Counter
| Empty Counter match | |
|---|---|
| Type: | match |
| Status: | supported |
| First version: | 4.8 |
| Copyright: | 2009 Florian octo Forster |
| License: | MIT license |
| Manpage: | collectd.conf(5) |
| List of Matches | |
Description
The Empty Counter match matches value lists, where at least one data source is of type COUNTER and the counter value of all counter data sources is zero. For instance, an if_octets value list will only be matched if both, rx and tx hold the value zero.
The counter value is an integer value which is only increased, for example counting the number of octets sent or received by a network interface since it has been brought up. Usually those counter values are converted to a rate when drawing a graph. If you want to match value lists with a rate of zero, please take a look at the Value match instead.
The goal of this match is to match “inactive” counters, such as inactive IRQs (see example below), unconnected ports queried via SNMP and so on. These counters usually are of little to no interest but not all plugins provide appropriate selection mechanisms.
Synopsis
Match "empty_counter"
Example
# Ignore all "irq" values if they are inactive
<Rule "ignore_empty_irq">
<Match "regex">
Type "^irq$"
</Match>
Match "empty_counter"
Target "stop"
</Rule>
Dependencies
- none
History
The Value match has been available since version 4.8.0.
