Skip to main content

Cisco Entity Sensor (SNMP)

Description​

This connector discovers the enclosure Cisco Ethernet switches as well as the various environment sensors (temperatures, fans, power supplies, etc.). It relies on the SNMP protocol.

cisco hardware network

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Supersedes

This connector supersedes:

Target​

Typical platform: Cisco Networking

Operating system: Network Device

Prerequisites​

Leverages: Cisco SNMP Agent (ciscoMgmt)

Technology and protocols: SNMP

Examples​

CLI​

metricshub HOSTNAME -t network -c +CiscoEntitySensor --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: [ +CiscoEntitySensor ] # 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 Cisco Entity Sensor (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
  • An SNMP GetNext on the OID 1.3.6.1.4.1.9.9.91.1.1.1.1 must return a non-empty value
  • An SNMP GetNext on the OID 1.3.6.1.2.1.47.1.1.1.1 must return a non-empty value

Metrics​

TypeCollected MetricsSpecific Attributes
enclosurehw.enclosure.energy
hw.enclosure.power
hw.status{hw.type="enclosure", state="present"}		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
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.type
id
name
physical_address
physical_address_type
power_supplyhw.status{hw.type="power_supply", state="degraded|failed|ok"}
hw.status{hw.type="power_supply", state="present"}		hw.parent.id
hw.parent.type
id
info
name
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