Match:Empty Counter

From collectd Wiki
Jump to: navigation, search
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

Contents

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.

Personal tools
Namespaces

Variants
Actions
Navigation
Tools