Skip to content

Check network-bonding

Overview

Reports the state of network bonding (channel bonding) interfaces. Checks that all slave interfaces are active and that the bonding mode and link status are healthy. Channel bonding allows two or more network interfaces to act as one, increasing bandwidth and providing redundancy. Requires root or sudo.

Data Collection:

  • Reads bonding interface status from /proc/net/bonding/
  • Parses MII status, link failure count, bonding mode, and partner MAC address for each bond and its slave interfaces

Fact Sheet

Fact Value
Check Plugin Download https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/network-bonding
Nagios/Icinga Check Name check_network_bonding
Check Interval Recommendation Every minute
Can be called without parameters Yes
Runs on Linux
Compiled for Windows No

Help

usage: network-bonding [-h] [-V] [--always-ok] [--test TEST]

Reports the state of network bonding (channel bonding) interfaces. Checks that
all slave interfaces are active and that the bonding mode and link status are
healthy. Channel bonding allows two or more network interfaces to act as one,
increasing bandwidth and providing redundancy. Alerts when any slave interface
is down or the bond is degraded. Requires root or sudo.

options:
  -h, --help     show this help message and exit
  -V, --version  show program's version number and exit
  --always-ok    Always returns OK.
  --test TEST    For unit tests. Needs "path-to-bonding-file". Example:
                 `--test /tmp/bond0`.

Usage Examples

./network-bonding

Output:

One or more errors.

* [WARNING] bond0 (IEEE 802.3ad Dynamic link aggregation)
    * Could not detect the MAC Address of the switch. This could indicate that LACP is not configured properly.

States

  • OK if all bonding interfaces and their slaves are healthy.
  • WARN if any slave interface in a bond is not up.
  • WARN if LACP partner MAC address cannot be detected.
  • UNKNOWN if no bonding interfaces are found.
  • --always-ok suppresses all alerts and always returns OK.

Perfdata / Metrics

Name Type Description
\<bond>_\<slave>_link_failure_count Number Link failure count per slave interface.

Credits, License