Skip to main content

Windows machine monitoring with Netdata

This module will monitor one or more Windows machines, using the windows_exporter.

The module collects metrics from the following collectors:

Installation: please follow the official guide.

Requirements

windows_exporter version v0.13.0+

  • On your Windows machine download the latest version of the windows_exporter msi

  • Install the windows_exporter with msiexec and the parameters shown below:

    msiexec -i <path-to-msi-file> ENABLED_COLLECTORS=cpu,memory,net,logical_disk,os,system,logon,thermalzone

    The msi installer automatically adds and starts a service called windows_exporter, which listens to port 9182 by default. Full installation instructions options can be found here.

  • Verify that the exporter works properly by accessing http://localhost:9182/

Metrics

All metrics have "wmi." prefix.

MetricScopeDimensionsUnits
cpu_utilization_totalglobaldpc, user, privileged, interruptpercentage
cpu_dpcsglobala dimension per coredpcs/s
cpu_interruptsglobala dimension per coreinterrupts/s
cpu_utilizationcpu coredpc, user, privileged, interruptpercentage
cpu_cstatecpu corec1, c2, c3percentage
memory_utilizationglobalavailable, usedKiB
memory_page_faultsglobalpage_faultsevents/s
memory_swap_utilizationglobalavailable, usedKiB
memory_swap_operationsglobalread, writeoperations/s
memory_swap_pagesglobalread, writtenpages/s
memory_cachedglobalcachedKiB
memory_cache_faultsglobalcache_faultsevents/s
memory_system_poolglobalpaged, non-pagedKiB
net_bandwidthnetwork devicereceived, sentkilobits/s
net_packetsnetwork devicereceived, sentpackets/s
net_errorsnetwork deviceinbound, outbounderrors/s
net_discardednetwork deviceinbound, outbounddiscards/s
logical_disk_utilizationlogical diskfree, usedKiB
logical_disk_utilizationlogical diskread, writeKiB/s
logical_disk_operationslogical diskreads, writesoperations/s
logical_disk_latencylogical diskread, writemilliseconds
os_processesglobalprocessesnumber
os_usersglobalusersusers
os_visible_memory_usageglobalfree, usedbytes
os_paging_files_usageglobalfree, usedbytes
system_threadsglobalthreadsnumber
system_uptimeglobaltimeseconds
logon_type_sessionsglobalsystem, interactive, network, batch, service, proxy, unlock, network_clear_text, new_credentials, remote_interactive, cached_interactive, cached_remote_interactive, cached_unlockseconds
thermalzone_temperatureglobala dimension per thermalzonecelsius

Configuration

Edit the go.d/wmi.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/wmi.conf

Needs only url to windows_exporter metrics endpoint. Here is an example for 2 instances:

jobs:
- name: win_server1
url: http://203.0.113.10:9182/metrics

- name: win_server2
url: http://203.0.113.11:9182/metrics

For all available options please see module configuration file.

Troubleshooting

To troubleshoot issues with the wmi collector, run the go.d.plugin with the debug option enabled. The output should give you clues as to why the collector isn't working.

  • Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on your system, open netdata.conf and look for the plugins setting under [directories].

    cd /usr/libexec/netdata/plugins.d/
  • Switch to the netdata user.

    sudo -u netdata -s
  • Run the go.d.plugin to debug the collector:

    ./go.d.plugin -d -m wmi

Was this page helpful?

Contribute