# README

NetDevStatus

Description

The NetDevStatus collector picks information about the state of network interfaces.
The following metrics are available for each interface:

NameTypeData sourceDescription
OperStategauge/sys/class/net/[iface]/operstateThe oper state of interface: 1 - "up", 2 - "lowerlayerdown", 3 - "dormant", 4 - "down", 5 - "unknown", 6 - "testing", 7 - "notpresent". Details: https://tools.ietf.org/html/rfc2863#section-3.1.14
LinkFlapscounter/sys/class/net/[iface]/carrier_changesThe number of link flaps.
Speedgauge/sys/class/net/[iface]/speedThe link speed in MB/s.
Duplexgauge/sys/class/net/[iface]/duplexDuplex: 1 - "full", 2 - "half", 3 - "unknown". Details: https://www.kernel.org/doc/Documentation/ABI/testing/sysfs-class-net.
MTUgauge/sys/class/net/[iface]/mtuThe MTU value for the interface.

Configuration

{
  "collectors": {
    "NetDevStatus": {
      "enabled": true,
      "excludeWireless": true,
      "excludeByName": []
    }
  }
}
  • "enabled"
    • true - enable collector
    • false - disable collector
  • "excludeWireless"
    • true - exclude wireless interfaces
    • false - do not exclude wireless interfaces
  • "excludeByName" - list of interface names to exclude. Possible states: "unknown", "notpresent", "down", "lowerlayerdown", "testing", "dormant", "up" (Details: https://tools.ietf.org/html/rfc2863#section-3.1.14)