Bond Input Plugin
This plugin collects metrics for both the network bond interface as well as its
slave interfaces using /proc/net/bonding/* files.
Introduced in: Telegraf v1.5.0 Tags: system OS support: all
Global configuration options
In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.
Configuration
# Collect bond interface status, slaves statuses and failures count
[[inputs.bond]]
## Sets 'proc' directory path
## If not specified, then default is /proc
# host_proc = "/proc"
## Sets 'sys' directory path
## If not specified, then default is /sys
# host_sys = "/sys"
## By default, telegraf gather stats for all bond interfaces
## Setting interfaces will restrict the stats to the specified
## bond interfaces.
# bond_interfaces = ["bond0"]
## Tries to collect additional bond details from /sys/class/net/{bond}
## currently only useful for LACP (mode 4) bonds
# collect_sys_details = falseMetrics
bond
- tags:
bond: name of the bond
- fields:
active_slave: currently active slave interface for active-backup modestatus: status of the interface (0: down , 1: up)
- tags:
bond_slave
- tags:
bond: name of the bondinterface: name of the network interface
- fields:
failures: amount of failures for bond’s slave interfacestatus: status of the interface (0: down , 1: up)count: number of slaves attached to bondactor_churned (for LACP bonds): count for local end of LACP bond flappedpartner_churned (for LACP bonds): count for remote end of LACP bond flappedtotal_churned (for LACP bonds): full count of all churn events
- tags:
bond_sys
- tags:
bond: name of the bondmode: name of the bonding mode
- fields:
slave_count: number of slavesad_port_count: number of ports
- tags:
Example Output
Configuration:
[[inputs.bond]]
## Sets 'proc' directory path
## If not specified, then default is /proc
host_proc = "/proc"
## By default, telegraf gather stats for all bond interfaces
## Setting interfaces will restrict the stats to the specified
## bond interfaces.
bond_interfaces = ["bond0", "bond1"]Run:
telegraf --config telegraf.conf --input-filter bond --testOutput:
bond,bond=bond1,host=local active_slave="eth0",status=1i 1509704525000000000
bond_slave,bond=bond1,interface=eth0,host=local status=1i,failures=0i 1509704525000000000
bond_slave,host=local,bond=bond1,interface=eth1 status=1i,failures=0i 1509704525000000000
bond_slave,host=local,bond=bond1 count=2i 1509704525000000000
bond,bond=bond0,host=isvetlov-mac.local status=1i 1509704525000000000
bond_slave,bond=bond0,interface=eth1,host=local status=1i,failures=0i 1509704525000000000
bond_slave,bond=bond0,interface=eth2,host=local status=1i,failures=0i 1509704525000000000
bond_slave,bond=bond0,host=local count=2i 1509704525000000000Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for Telegraf and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.