/usr/share/doc/check-mk-doc/checks/netctr.combined is in check-mk-doc 1.1.12-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 | title: Monitor errors and traffic over network interfaces
agents: linux
author: Mathias Kettner <mk@mathias-kettner.de>
license: GPL
distribution: check_mk
description:
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.
Note: this check is deprecated. Better use {lnx_if}. Set {linux_nic_check = "lnx_if"}
in your configuration in order to turn on inventory of {lnx_if} and turn it
of for this check.
item:
The name of the network interface as shown by {ifconfig},
for example {"eth0"}
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' ]
perfdata:
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.
[parameters]
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.
[configuration]
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.
|