Back to the list of connectors

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.

Connector ID: MIB2Switch

This connector supersedes:

Target

Typical platform: MIB-2 and Entity-Sensor-MIB Supported Switch

Operating system: Network Device

Prerequisites

Leverages: MIB-2 Standard SNMP Agent

Technology and protocols: SNMP

Examples

CLI

hws HOSTNAME -t network -f MIB2Switch --snmp v2c --community public

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: network
  selectedConnectors: [ MIB2Switch ] # Optional, to load only this connector
  snmp:
    version: v1 # Read documentation for v2 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 Get-Next on the OID 1.3.6.1.2.1.2.2.1 must return a value in the same subtree
  • An SNMP Get-Next on the OID 1.3.6.1.2.1.99 must return a value in the same subtree

Metrics

Type Collected Metrics Specific Attributes (Labels)
Enclosure
  • hw.status{hw.type="enclosure",state="present"}
  • bios_version
  • model
  • serial_number
  • type
  • vendor
Fan
  • hw.fan.speed
  • hw.status{hw.type="fan",state="ok|degraded|failed"}
  • hw.status{hw.type="fan",state="present"}
  • info
Network Card, FC Port
  • hw.errors{hw.type="network"}
  • hw.network.bandwidth.limit
  • hw.network.bandwidth.utilization
  • 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="ok|degraded|failed"}
  • hw.status{hw.type="network",state="present"}
  • physical_address
Temperature Sensor
  • hw.status{hw.type="temperature",state="ok|degraded|failed"}
  • hw.status{hw.type="temperature",state="present"}
  • hw.temperature
    Voltage Sensor
    • hw.status{hw.type="voltage",state="ok|degraded|failed"}
    • hw.status{hw.type="voltage",state="present"}
    • hw.voltage
    • sensor_location
    No results.