Skip to main content

SuperMicro (REST)

Description​

This connector enables hardware monitoring for SuperMicro Systems via Redfish REST API. It monitors the enclosures and physical disks as well as various environment sensors (CPUs, temperatures, fans, power supplies, memory modules and network cards).

hardware supermicro

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Supersedes

This connector supersedes:

Target​

Typical platform: SuperMicro

Operating system: Out-Of-Band

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

Prerequisites​

Leverages: SuperMicro Baseboard Management Controller REST API

Technology and protocols: HTTP

Examples​

CLI​

metricshub HOSTNAME -t oob -c +SuperMicro --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: [ +SuperMicro ] # 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 SuperMicro (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:
    • GET /redfish/v1/Systems/1
    • Request Header: Authorization: Basic %{BASIC_AUTH_BASE64}
    • The response body contains: Supermicro (regex)

Metrics​

TypeCollected MetricsSpecific Attributes
cpuhw.cpu.speed.limit{limit_type="max"}
hw.status{hw.type="cpu", state="degraded|failed|ok"}
hw.status{hw.type="cpu", state="present"}		hw.parent.id
hw.parent.type
id
model
name
vendor
enclosurehw.status{hw.type="enclosure", state="degraded|failed|ok"}
hw.status{hw.type="enclosure", state="present"}		id
model
name
serial_number
type
vendor
fanhw.fan.speed
hw.fan.speed.limit{limit_type="low.critical"}
hw.fan.speed.limit{limit_type="low.degraded"}
hw.fan.speed_ratio
hw.status{hw.type="fan", state="degraded|failed|ok"}
hw.status{hw.type="fan", state="present"}		hw.parent.id
hw.parent.type
id
name
memoryhw.memory.limit
hw.status{hw.type="memory", state="degraded|failed|ok"}
hw.status{hw.type="memory", state="present"}		hw.parent.id
hw.parent.type
id
model
name
serial_number
type
vendor
networkhw.network.bandwidth.limit
hw.network.up
hw.status{hw.type="network", state="degraded|failed|ok"}
hw.status{hw.type="network", state="present"}		hw.parent.id
hw.parent.type
id
name
physical_address
physical_diskhw.status{hw.type="physical_disk", state="degraded|failed|ok"}
hw.status{hw.type="physical_disk", state="present"}		hw.parent.id
hw.parent.type
id
model
name
vendor
power_supplyhw.power_supply.limit
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
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