Back to the list of connectors[1]

Windows - Processes (WMI)

Description

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

system[2] windows[3]

Source[4]

Target

Typical platform: Any Windows system

Operating system: Microsoft Windows

Prerequisites

Leverages: WMI

Technology and protocols: WMI/WinRM

Variables:

  • matchCommand: Regular expression pattern to match process command lines for monitoring. (default: .*)
  • matchName: Regular expression pattern to match process 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

CLI

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

metricshub.yaml

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
        variables:
          matchCommand: <VALUE> # Replace with desired value.
          matchName: <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

Type Collected Metrics Specific Attributes
process
  • process.cpu.time
  • process.cpu.utilization
  • process.disk.io{disk.io.direction="read"}
  • process.disk.io{disk.io.direction="write"}
  • process.disk.operations{disk.io.direction="read"}
  • process.disk.operations{disk.io.direction="write"}
  • process.handle.count
  • process.memory.usage
  • process.memory.virtual
  • process.paging.faults
  • process.thread.count
  • id
  • process.id
  • process.match.command
  • process.match.name
  • process.name
  • process.parent.id
No results.