Back to the list of connectors[1]

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).

This connector supersedes:

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

Target

Typical platform: Cisco UCS

Operating system: Out-Of-Band

Prerequisites

Leverages: Cisco UCS Manager (REST XML API)

Technology and protocols: HTTP/REST

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

Examples

CLI

metricshub HOSTNAME -t management -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: management
        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:
    • 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
No results.