Skip to content

Latest commit

 

History

History
104 lines (82 loc) · 3.22 KB

README.md

File metadata and controls

104 lines (82 loc) · 3.22 KB
Raw

Bond Input Plugin

This plugin collects metrics for both the network bond interface as well as its slave interfaces using /proc/net/bonding/* files.

⭐ Telegraf v1.5.0 🏷️ system 💻 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 = false

Metrics

  • bond

    • tags:
      • bond: name of the bond
    • fields:
      • active_slave: currently active slave interface for active-backup mode
      • status: status of the interface (0: down , 1: up)

  • bond_slave

    • tags:
      • bond: name of the bond
      • interface: name of the network interface
    • fields:
      • failures: amount of failures for bond's slave interface
      • status: status of the interface (0: down , 1: up)
      • count: number of slaves attached to bond
      • actor_churned (for LACP bonds): count for local end of LACP bond flapped
      • partner_churned (for LACP bonds): count for remote end of LACP bond flapped
      • total_churned (for LACP bonds): full count of all churn events

  • bond_sys

    • tags:
      • bond: name of the bond
      • mode: name of the bonding mode
    • fields:
      • slave_count: number of slaves
      • ad_port_count: number of ports

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 --test

Output:

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 1509704525000000000