bond

package
v1.22.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 23, 2022 License: MIT Imports: 8 Imported by: 11

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"

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

Measurements & Fields

  • bond

    • active_slave (for active-backup mode)
    • status
  • bond_slave

    • failures
    • status
    • count
    • actor_churned (for LACP bonds)
    • partner_churned (for LACP bonds)
    • total_churned (for LACP bonds)
  • bond_sys

    • slave_count
    • ad_port_count

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.
  • count
    • Number of slaves attached to bond
  • actor_churned
    • number of times local end of LACP bond flapped
  • partner_churned
    • number of times remote end of LACP bond flapped
  • total_churned
    • full count of all churn events

Tags

  • bond

    • bond
  • bond_slave

    • bond
    • interface
  • bond_sys

    • bond
    • mode

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:

```shell
telegraf --config telegraf.conf --input-filter bond --test

Output:

```shell
* 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_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

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Bond

type Bond struct {
	HostProc       string   `toml:"host_proc"`
	HostSys        string   `toml:"host_sys"`
	SysDetails     bool     `toml:"collect_sys_details"`
	BondInterfaces []string `toml:"bond_interfaces"`
	BondType       string
}

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

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL