bond

README

Bond Input Plugin

The Bond input plugin collects network bond interface status for both the network bond interface as well as slave interfaces. The plugin collects these metrics from /proc/net/bonding/* files.

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"]

Measurements & Fields:

• bond

  • active_slave (for active-backup mode)
  • status

• bond_slave

  • failures
  • status

Description:

active_slave
  Currently active slave interface for active-backup mode.

status
  Status of bond interface or bonds's slave interface (down = 0, up = 1).

failures
  Amount of failures for bond's slave interface.

Tags:

• bond

  • bond

• bond_slave

  • bond
  • interface

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:

* Plugin: inputs.bond, Collection 1
> 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,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

Documentation

Index

• type Bond
  • func (bond *Bond) Description() string
  • func (bond *Bond) Gather(acc telegraf.Accumulator) error
  • func (bond *Bond) SampleConfig() string

Types

type Bond

type Bond struct {
	HostProc       string   `toml:"host_proc"`
	BondInterfaces []string `toml:"bond_interfaces"`
}

func (*Bond) Description

func (bond *Bond) Description() string

func (*Bond) Gather

func (bond *Bond) Gather(acc telegraf.Accumulator) error

func (*Bond) SampleConfig

func (bond *Bond) SampleConfig() string