WMI - Network

Description

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

hardware windows

Superseded Connector

This connector is superseded by:

• CpqNICiLO
• MIB2NT

Target

Typical platform: Microsoft Windows

Operating system: Microsoft Windows

Prerequisites

Leverages: WMI

Technology and protocols: WMI

Examples

CLI

metricshub HOSTNAME -t win -c +WBEMGenNetwork --wmi -u USER

metricshub.yaml

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: win
        connectors: [ +WBEMGenNetwork ] # 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 - Network connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

• The device type must be one of: NT
• The Windows service WINMGMT is present and running
• The WMI query below succeeds:
  • Namespace: root\wmi
  • Query: SELECT InstanceName FROM MSNdis_MediaConnectStatus
• The WMI query below succeeds:
  • Namespace: root\cimv2
  • Query: SELECT AdapterType FROM Win32_NetworkAdapter
  • Result contains: ^Ethernet 802\.3;$ (regex)

Metrics

Type	Collected Metrics	Specific Attributes
network	hw.errors{hw.type="network"} hw.network.bandwidth.limit 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="degraded|failed|ok"} hw.status{hw.type="network", state="present"}	hw.parent.type id info model name physical_address physical_address_type