---
date_published: 2026-08-13
date_modified: 2026-08-13
canonical_url: https://metricshub.org/community-connectors/connectors/wbemgenhba.html
---

 [Supported Platforms](../supported-platforms.html)   [Connectors Directory](../connectors-directory.html)

# WMI - HBA

## Description

This connector enables the monitoring of HBA cards on all Windows-based systems through the WMI layer (root/WMI namespace).

This connector supersedes: 

- [CpqHBA](cpqhba.html)
- [SMISHBA](smishba.html)

[community](tags/community.html) [hardware](tags/hardware.html) [windows](tags/windows.html)

[Source](https://github.com/metricshub/community-connectors/tree/main/src/main/connector/hardware/WBEMGenHBA/WBEMGenHBA.yaml)

## Target

Typical platform: **[Microsoft Windows](platforms/microsoft-windows.html)**

Operating system: **Microsoft Windows**

## Prerequisites

Leverages: **WMI**

Technology and protocols: **WMI/WinRM**

## Examples

### CLI

```batch
metricshub HOSTNAME -t win -c +WBEMGenHBA --wmi -u USER
```

### metricshub.yaml

```yaml
resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: win
        connectors: [ +WBEMGenHBA ] # Optional, to load only this connector
        protocols:
          wmi:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt
```

## Connector Activation Criteria

The **WMI - HBA** connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

- Operating System is **Microsoft Windows**
- The Windows service **WINMGMT** is running
- The **WMI query** below to the managed host succeeds: 
  
    - Namespace: `root\wmi`
    - WQL Query: `SELECT InstanceName FROM MSFC_FCAdapterHBAAttributes`

## Metrics

| Type | Collected Metrics | Specific Attributes |
| --- | --- | --- |
| **network** | - `hw.errors{hw.type="network"}` - `hw.network.bandwidth.limit` - `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"}` | - `bandwidth` - `device_type` - `hw.parent.type` - `id` - `model` - `name` - `physical_address` - `physical_address_type` - `vendor` |