Back to the list of connectors

WMI - Network

Description

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

Connector ID: WBEMGenNetwork

This connector is superseded by:

Target

Typical platform: Any system

Operating system: Microsoft Windows

Prerequisites

Leverages: WMI

Technology and protocols: WMI

Examples

CLI

hws HOSTNAME -t win -f WBEMGenNetwork --wmi -u USER

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: win
  selectedConnectors: [ WBEMGenNetwork ] # Optional, to load only this connector
  wmi:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt

Connector Activation Criteria

The WMI - Network 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 MSNdis_MediaConnectStatus
  • The WMI query below to the managed host succeeds:
    • Namespace: root\cimv2
    • WQL Query: SELECT AdapterType FROM Win32_NetworkAdapter
    • Result contains: ^Ethernet 802\.3;$ (regex)

Metrics

Type Collected Metrics Specific Attributes (Labels)
Network Card, FC Port
  • hw.errors{hw.type="network"}
  • hw.network.bandwidth.limit
  • hw.network.bandwidth.utilization
  • 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="ok|degraded|failed"}
  • hw.status{hw.type="network",state="present"}
  • info
  • model
  • physical_address
No results.