Description

Monitors essential performance metrics of any Windows system through WMI, following OpenTelemetry semantic conventions.

community^[2] system^[3] windows^[4]

Source^[5]

Target

Typical platform: Any Windows system

Operating system: Microsoft Windows

Prerequisites

Leverages: WMI

Technology and protocols: WMI/WinRM

Variables:

• matchDomain: Regular expression pattern to match domain names for monitoring. (default: .*)
• matchCommand: Regular expression pattern to match process command lines for monitoring. (default: .*)
• matchName: Regular expression pattern to match process names for monitoring. (default: .*)
• matchUser: Regular expression pattern to match user names for monitoring. (default: .*)

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

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

Examples

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

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: win
        connectors: [ +WindowsProcess ] # Optional, to load only this connector
        protocols:
          wmi:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt
        additionalConnectors:
          WindowsProcess: # Unique ID. Use 'uses' if different from the original connector ID
            uses: WindowsProcess # Optional - Original ID if not in key
            force: true # Optional (default: true); false for auto-detection only
            variables:
              matchDomain: <VALUE> # Replace with desired value.
              matchCommand: <VALUE> # Replace with desired value.
              matchName: <VALUE> # Replace with desired value.
              matchUser: <VALUE> # Replace with desired value.

Connector Activation Criteria

The Windows - Processes (WMI) connector must be selected manually, and its status will be reported as OK if all the below criteria are met:

• The WMI query below to the managed host succeeds:
  • Namespace: root\CIMv2
  • WQL Query: SELECT Name FROM Win32_OperatingSystem

Metrics