Back to the list of connectors[1]

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.

This connector supersedes:

cisco[4] enterprise[5] hardware[6] network[7]

Target

Typical platform: Cisco

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 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.4.1.9.9.91.1.1.1.1 must return a value in the same subtree
  • An SNMP Get-Next on the OID 1.3.6.1.2.1.47.1.1.1.1 must return a value in the same subtree

Metrics

Type Collected Metrics Specific Attributes
enclosure
  • hw.enclosure.energy
  • hw.enclosure.power
  • hw.status{hw.type="enclosure", state="present"}
  • id
  • model
  • name
  • serial_number
  • type
  • vendor
fan
  • hw.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
network
  • hw.errors{hw.type="network"}
  • hw.network.bandwidth.limit
  • 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.parent.type
  • id
  • name
  • physical_address
  • physical_address_type
power_supply
  • hw.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
temperature
  • hw.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
voltage
  • hw.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
No results.