Skip to main content

Ethernet Switch with Sensors (SNMP)

Description​

This connector discovers the enclosure and Ethernet ports of a system equipped with an MIB-2 standard SNMP Agent.

hardware network

Supersedes

This connector supersedes:

Target​

Typical platforms: SNMP, Arista

Operating system: Network Device

Prerequisites​

Leverages: MIB-2, Entity-Sensor-MIB, SNMP

Technology and protocols: SNMP

Examples​

CLI​

metricshub HOSTNAME -t network -c +MIB2Switch --snmp v2c --community public

metricshub.yaml​

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: network
        connectors: [ +MIB2Switch ] # Optional, to load only this connector
        protocols:
          snmp:
            version: v2c # Read documentation for v1, v2c and v3
            community: public # or probably something more secure

Connector Activation Criteria​

The Ethernet Switch with Sensors (SNMP) connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

  • An SNMP GetNext on the OID 1.3.6.1.2.1.2.2.1 must return a non-empty value

Metrics​

TypeCollected MetricsSpecific Attributes
enclosurehw.status{hw.type="enclosure", state="present"}bios_version
id
model
name
serial_number
type
vendor
fanhw.fan.speed
hw.status{hw.type="fan", state="degraded|failed|ok"}
hw.status{hw.type="fan", state="present"}		hw.parent.id
hw.parent.type
id
info
name
networkhw.errors{hw.type="network"}
hw.network.bandwidth.limit
hw.network.dropped{network.io.direction="receive"}
hw.network.dropped{network.io.direction="transmit"}
hw.network.io{direction="receive"}
hw.network.io{direction="transmit"}
hw.network.packets{direction="receive"}
hw.network.packets{direction="transmit"}
hw.network.up
hw.status{hw.type="network", state="degraded|failed|ok"}
hw.status{hw.type="network", state="present"}		device_type
hw.network.alias
hw.network.name
hw.parent.id
hw.parent.type
id
name
physical_address
physical_address_type
temperaturehw.status{hw.type="temperature", state="degraded|failed|ok"}
hw.status{hw.type="temperature", state="present"}
hw.temperature		hw.parent.id
hw.parent.type
id
name
voltagehw.status{hw.type="voltage", state="degraded|failed|ok"}
hw.status{hw.type="voltage", state="present"}
hw.voltage		hw.parent.id
hw.parent.type
id
name
sensor_location