Skip to main content

Generic Ethernet Switch

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 SNMP

Technology and protocols: SNMP

Examples

CLI

metricshub HOSTNAME -t network -c +GenericSwitchEnclosure --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: [ +GenericSwitchEnclosure ] # 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 Generic Ethernet Switch 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"}id
name
type
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