Cisco UCS Manager (REST)

Description

This connector enables hardware monitoring for Cisco UCS Blade chassis (as well as the Cisco Fabric Interconnect Switch) through the REST UCS Manager (running on the Fabric Interconnect Switch).

cisco hardware

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Supersedes

This connector supersedes:

• CiscoUCSBladeSNMP

Target

Typical platform: Cisco UCS

Operating system: Out-Of-Band

This connector is not available for the local host (it is applicable to remote hosts only).

Prerequisites

Leverages: Cisco UCS Manager (REST XML API)

Technology and protocols: HTTP

Examples

CLI

metricshub HOSTNAME -t oob -c +CiscoUCSRest --https --http-port 443 -u USERNAME

metricshub.yaml

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: oob
        connectors: [ +CiscoUCSRest ] # Optional, to load only this connector
        protocols:
          http:
            https: true
            port: 443 # or probably something else
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt

Connector Activation Criteria

The Cisco UCS Manager (REST) connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

• The HTTP Request below to the managed host succeeds:
  • POST /nuova
  • Request Header: Content-Type: application/xml
  • Request Body: <aaaLogin inName=" inPassword=" />
  • The response body contains: Authentication failed (regex)

Metrics

Type	Collected Metrics	Specific Attributes
blade	hw.status{hw.type="blade", state="degraded|failed|ok"} hw.status{hw.type="blade", state="present"}	blade_name hw.parent.id hw.parent.type id info model name serial_number
enclosure	hw.enclosure.energy hw.enclosure.power hw.status{hw.type="enclosure", state="degraded|failed|ok"} 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 info name sensor_location
network	hw.network.bandwidth.limit hw.network.full_duplex 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.id hw.parent.type id info model 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 power_supply_type
temperature	hw.status{hw.type="temperature", state="present"} hw.temperature	hw.parent.id hw.parent.type id name sensor_location