Check manual page of aix_if

AIX: State of Network Interfaces
Distribution official part of Check_MK
License GPL
Supported Agents AIX
This check monitors

- the operational status

- link speed

- traffic

- packet counts

- errors

of network interfaces of AIX hosts using data sent by the Checkmk agent.

It is fully compatible with if and if64 and shares all of its features, including Perf-O-Meter, averaging, flexible configuration and NagVis weathermaps.

Depending on the check parameters this service goes WARN or CRIT when

- the port status changes (i.e. is down),

- the link speed changes (e.g. a port expected to be set to 1 GBit/s operates only at 100 MBit/s)

- the absolute or procentual traffic of a port exceeds certain levels

- the rate of errors exceeds configurable limits.

This check supports averaging the in- and outgoing traffic over a configurable time range by using an exponentially weighted moving average - just as Linux does for the CPU load averages. The averaging can be configured on a per-host and per-interface base. Interfaces with averaging turned on yield two additional performance values: the averaged in- and outgoing traffic in bytes. If you have configured traffic levels, then those levels are applied to the averaged values.


There are three allowed ways to specify an interface: its index, which simply enumerates the interfaces starting from 1, its description and its alias. For this check, the description and the alias are the same.


One service is created for each interface that fulfills configurable conditions (rule "Network interface and switch port discovery"). By default, these are interfaces which are currently found {up} and are of type 6, 32, 62, 117, 127, 128, 129, 180, 181, 182, 205 or 229. {Grouping:} In some situations, you do not want to monitor a single interface but a group of interfaces that together form a pool. This check supports such pools by defining groups. The data of all members is accumulated and put together in a single grouped interface service.