Overview

This page is the technical reference for VCF SAN Insight. Everything described here appears in VCF Operations once an adapter instance has been configured and a collection has completed. Two vendors are supported — Broadcom Brocade and Cisco MDS — and the object model is shared, so the same dashboards, alerts, custom groups and relationships serve every producer.

Dashboards

All dashboards are shipped inside the Management Pack, are placed in a dedicated folder named after the product, and are installed automatically with the adapter content.

SAN Inventory

The inventory dashboard is the starting point for the fabric: it lists every fabric and switch with its model, firmware version, CPU and memory usage and operational status, and shows the number of zones per fabric. Filtering and automatic refresh make it usable on a daily basis.

SAN Zones

The zones dashboard presents zone membership grouped by fabric: the zone name, the zone configuration it belongs to and the members inside it. With the member count metric and the resource list, an administrator can see how segmentation is laid out across the fabric without logging into each switch.

SAN Health

The health dashboard highlights faulty devices on a heatmap coloured by the health badge, together with the active alerts. It is the operator view used to spot a switch or a port that has started to degrade.

Custom groups

Custom groupDescription
SAN WorldEvery object collected by the Management Pack: fabrics, switches, chassis and ports
SAN ChassisAll chassis objects, grouped by vendor
SAN FabricsAll fabric objects
SAN SwitchesAll switch objects

Collected objects

The object model is vendor-neutral; no object kind carries a vendor name. The producer is distinguished only by the vendor property on each object.

Relationships

The topology is rebuilt on every collection cycle:

  • the adapter instance is the root of the hierarchy
  • a fabric parents the switches that are members of it
  • a chassis parents the switches installed in it
  • a switch parents its ports
  • a port is related to the ESXi host that is logged in through it, and to the storage array that is visible on it, giving the full path Switch → Port → Host / Switch → Port → Storage Array
  • a switch parents its VSANs and its zones

SAN Fabric

Data nameTypeDescription
IDIdentifierUnique identifier of the fabric
NamePropertyName of the fabric
Zone → Zone configuration namePropertyZone configuration the zone belongs to
Zone → Member CountMetricNumber of members in the zone
Zone → Member → NamePropertyName of a zone member

SAN Switch

Data nameTypeDescription
WWNIdentifierWorld Wide Name of the switch, the object key
WWNPropertyWorld Wide Name
User Friendly NamePropertyDescriptive name of the switch
Firmware versionPropertyFabric OS or NX-OS version
Domain IDPropertyDomain identifier inside the fabric
Switch TypePropertyType or category of the switch
PrincipalPropertyWhether this is the principal switch of the fabric
Ethernet IPv4PropertyIPv4 address of the management interface
Ethernet IPv6PropertyIPv6 address of the management interface
ModelPropertyModel of the switch
ManufacturerPropertyProducer of the device
Sequence numberPropertyManufacturer-assigned sequence number
TypePropertyType number of the device
Manufacturer PlantPropertyPlant where the switch was built
RND tagPropertyManufacturer asset tag
Fibre Channel IDPropertyFibre Channel ID of the switch
Fibre Channel ID HexPropertyFibre Channel ID in hexadecimal
CPU usageMetricCPU utilisation, percent
Memory usageMetricMemory utilisation, percent
Flash usageMetricFlash utilisation, percent
Enabled StateMetricAdministrative state of the switch
Operational StatusMetricCurrent operational status
UpTimeMetricTime since the last restart, seconds
Fan → Unit numberPropertyUnit number of the fan
Fan → Operational statePropertyCurrent state of the fan
Fan → Air flow directionPropertyDirection of the airflow
Fan → Part numberPropertyPart number of the fan
Fan → Serial numberPropertySerial number of the fan
Fan → Time aliveMetricTotal operational time, days
Fan → Time awakeMetricTotal active time, days
Fan → Power consumptionMetricPower drawn by the fan, watts
Fan → SpeedMetricFan speed, rpm
Power Supply → Unit numberPropertyUnit number of the power supply
Power Supply → Air flow directionPropertyDirection of the airflow
Power Supply → Power sourcePropertyPower source type
Power Supply → Operational statePropertyCurrent state of the power supply
Power Supply → Temperature sensor supportedPropertyWhether the unit carries a temperature sensor
Power Supply → Part numberPropertyPart number of the power supply
Power Supply → Serial numberPropertySerial number of the power supply
Power Supply → Time aliveMetricTotal operational time, days
Power Supply → Time awakeMetricTotal active time, days
Power Supply → Power productionMetricPower produced, watts
Power Supply → Input voltageMetricInput voltage, volts
Power Supply → TemperatureMetricTemperature of the unit, degrees Celsius
Power Supply → Power usageMetricPower consumed
Sensor → Slot NumberPropertySlot of the sensor
Sensor → IndexPropertyIndex of the sensor
Sensor → StatePropertyCurrent state
Sensor → CategoryPropertyCategory of the sensor
Sensor → TemperatureMetricTemperature, degrees Celsius

SAN Port

Data nameTypeDescription
Switch WWNIdentifierWorld Wide Name of the parent switch
Port NameIdentifierName of the port
NamePropertyName of the port
WWNPropertyWorld Wide Name of the port
Port IndexPropertyIndex of the port inside the switch
TypePropertyPort type
AuthenticationPropertyAuthentication protocol negotiated on the link
Is Enabled StatePropertyAdministrative state
User Friendly NamePropertyDescriptive name of the port
Vendor NamePropertyProducer of the optic
Vendor OUIPropertyOUI of the optic vendor
Vendor PNPropertyPart number of the optic
Vendor RevisionPropertyRevision of the optic
Serial NumberPropertySerial number of the optic
Data CodePropertyManufacturing data code
Media Form FactorPropertyForm factor of the transceiver
ConnectorPropertyConnector type
FC SpeedPropertyNegotiated Fibre Channel speed
DistancePropertySupported distance of the optic
EncodingPropertyEncoding of the transceiver
SpeedPropertyCurrent speed, Gbit/s
Device Port WWNPropertyWorld Wide Name of the device on the other end
Port Symbolic NamePropertySymbolic name of the port
Node NamePropertyWorld Wide Name of the node
Node Symbolic NamePropertySymbolic name of the node
Class Of ServicePropertyClass of service of the link
FC4 TypePropertyFC-4 protocols supported
FC4 FeaturesPropertyFC-4 features
Device Port TypePropertyPort type of the attached device
Device TypePropertyType of the attached device, from the name server
Link SpeedPropertyLink speed
VoltageMetricSupply voltage of the optic, millivolts
CurrentMetricLaser bias current, milliamps
Wave Length [nm]MetricWavelength of the optic
TemperatureMetricTemperature of the optic, degrees Celsius
TX Power [dBm]MetricTransmit optical power
RX Power [dBm]MetricReceive optical power
Power On TimeMetricPower-on hours of the transceiver
Max SpeedMetricMaximum supported speed, Gbit/s
Operational StatusMetricCurrent operational status of the port
Inbound OctetsMetricReceived octets
Outbound OctetsMetricTransmitted octets
Inbound TrafficMetricInbound throughput, bytes per second
Outbound TrafficMetricOutbound throughput, bytes per second

SAN Chassis

Data nameTypeDescription
WWNIdentifierWorld Wide Name of the chassis
User Friendly NamePropertyDescriptive name of the chassis
Chassis WWNPropertyWorld Wide Name of the chassis
License IDPropertyInstalled licence identifier
Serial NumberPropertySerial number of the chassis
ManufacturerPropertyProducer of the chassis
Part NumberPropertyPart number of the chassis
Supplier Serial NumberPropertySupplier serial number
Supplier Revision NumberPropertySupplier revision
Supplier Part NumberPropertySupplier part number
Product NamePropertyProduct name of the chassis

Alerts

The Management Pack ships the following alert definitions. They apply to every supported vendor, because they are built on the shared object model.

Temperature alerts

  • High Temperature — the element temperature is above the high threshold
  • Low Temperature — the element temperature is below the low threshold

Electrical current alerts

  • High Current — the electrical current is above the high threshold
  • Low Current — the electrical current is below the low threshold

Electrical voltage alerts

  • High Voltage — the electrical voltage is above the high threshold
  • Low Voltage — the electrical voltage is below the low threshold

Signal strength alerts

  • High RX — receive optical power is above the high threshold
  • Low RX — receive optical power is below the low threshold
  • High TX — transmit optical power is above the high threshold
  • Low TX — transmit optical power is below the low threshold

Resource usage alerts

  • High CPU Usage — CPU utilisation is above the high threshold
  • High Flash Usage — flash utilisation is above the high threshold
  • High Memory Usage — memory utilisation is above the high threshold

Events

The Management Pack raises VCF Operations events for the fabric events reported by the switch. The event levels collected are configurable per adapter instance: info, warning, immediately and critical.