View source for Match:Empty Counter

{{Infobox Match
  | Name=Empty Counter
  | Status= {{supported}}
  | FirstVersion={{Version|4.8}}
  | Copyright=''2009'' Florian octo Forster
  | License={{MIT License}}
  | Manpage={{Manpage|collectd.conf|5|item_empty_counter}}
}}
== Description ==

The '''Empty Counter match''' matches value lists, where at least one [[data source]] is of type <code>COUNTER</code> 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 [[Match:Value|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 ==

* <em>none</em>

== History ==

The <em>Value</em> match has been available since version 4.8.0.

[[Category:Matches]]
{{DEFAULTSORT:Empty counter}}