Skip to main content

Brocade SANnav Management Portal (REST)

Description​

This connector discovers Brocade SAN switches through the SANnav Management Portal REST API. It monitors switches (enclosures), Fibre Channel ports, and environment sensors (temperatures, fans, power supplies, etc.). Requires SANnav Management Portal version 2.x or 3.x.

brocade hardware network storage

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Supersedes

Target​

Typical platform: Brocade

Operating system: Network Device

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

Prerequisites​

Leverages: Brocade SANnav Management Portal REST API

Technology and protocols: HTTP

Examples​

CLI​

metricshub HOSTNAME -t network -c +BrocadeSANnavREST --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: network
connectors: [ +BrocadeSANnavREST ] # 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 Brocade SANnav Management Portal (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 /images/logo/Spectre/favicon.png
    • The entire response (header + body) contains: 200 (regex)
  • The HTTP Request below to the managed host succeeds:
    • get /external-api/v1/inventory/switches/
    • Request Header: Authorization: Basic %{BASIC_AUTH_BASE64} Accept: application/json
    • The entire response (header + body) contains: 200 (regex)

Metrics​

TypeCollected MetricsSpecific Attributes
bladehw.status{hw.type="blade", state="degraded|failed|ok"}
hw.status{hw.type="blade", state="present"}
id
model
name
type
vendor
enclosurehw.status{hw.type="enclosure", state="degraded|failed|ok"}
hw.status{hw.type="enclosure", state="present"}
id
model
name
type
vendor
fanhw.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
networkhw.network.bandwidth.limit
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
name
power_supplyhw.status{hw.type="power_supply", state="degraded|failed|ok"}
hw.status{hw.type="power_supply", state="present"}
hw.parent.id
hw.parent.type
id
name
temperaturehw.status{hw.type="temperature", state="degraded|failed|ok"}
hw.status{hw.type="temperature", state="present"}
hw.temperature
hw.temperature.limit{limit_type="high.critical"}
hw.temperature.limit{limit_type="high.degraded"}
hw.parent.id
hw.parent.type
id
name
sensor_location
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