Check manual page of netctr.combined

netctr.combined

Author: Mathias Kettner

License: GPL

Distribution: official part of check_mk

Supported Agents: Linux

This check measures the inbound and output traffic over a local network interface (such as eth0). Levels for warning and critical can be set on the error rate. The error rate is the number of errors and collisions compared to the number of packets transmitted during one check interval.

Item

The name of the network interface as shown by ifconfig, for example "eth0"

Check parameters

Parameter	Type	Description
warning	float	The percentage of errors at which a warning is triggered. If you set this to {0.5}, then you get a warning if in one check cycle at least one error occurs for each 200 packets sent or received.
critical	float	The percentage of errors at which a critical level is reached.

Performance data

Per default this check sends lots of performance variables: rx_bytes: the number of received bytes, tx_bytes: the number of transmitted bytes, rx_packets: the number of received packets, tx_packets: the number of transmitted packets, rx_errors: the number of errors while receiving, tx_errors: the number of transmission errors, tx_collisions: the number of collision. By setting netctr_counters you can change this list of variables.

Inventory

All network interfaces except lo and sit... are found and inventorized.

Configuration variables

Variable	Type	Description
netctr_default_params	float, float	Error percentages for warning and critical that are used by inventorized checks. This variable is preset to {(0.1, 0.01)}
netctr_counters	list of strings	The list of network counters that are sent as performance data and that are the basis for error computation. The default list is {rx_bytes}, {tx_bytes}, {rx_packets}, {tx_packets}, {rx_errors}, {tx_errors}, {tx_collisions}. Further available counters are {rx_drop}, {rx_fifo}, {rx_frame}, {rx_compressed}, {rx_multicast}, {tx_drop}, {tx_fifo}, {tx_carrier} and {tx_compressed}. Please note: If you change this parameter, you need to delete and recreate all existing round robin databases of this check type. You graphing tool most probably will not be able to alter the existing databases in order to reflect the changes.

Examples

# set levels to 0.01 promille for warning and 0.1 promille for errors
netctr_default_params = (0.01, 0.1)

# Reduce list of performance variables:
netctr_counters  = [ 'rx_bytes', 'tx_bytes', 'rx_errors', 'tx_errors' ]