Back to the list of connectors

Cisco Entity Sensor (SNMP)

Description

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

Connector ID: CiscoEntitySensor

This connector supersedes:

Target

Typical platform: Cisco

Operating system: Network Device

Prerequisites

Leverages: MIB-2 Standard SNMP Agent

Technology and protocols: SNMP

Examples

CLI

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

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: network
  selectedConnectors: [ CiscoEntitySensor ] # 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 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.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 (Labels)
Enclosure
  • hw.enclosure.energy
  • hw.status{hw.type="enclosure",state="present"}
  • 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"}
    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
    Power Supply
    • hw.status{hw.type="power_supply",state="ok|degraded|failed"}
    • hw.status{hw.type="power_supply",state="present"}
    • info
    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.