README
¶
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:
Requirements
windows_exporter version v0.13.0+
-
On your Windows machine download the latest version of the windows_exporter msi
-
Install the
windows_exporterwithmsiexecand the parameters shown below:msiexec -i <path-to-msi-file> ENABLED_COLLECTORS=cpu,memory,net,logical_disk,os,system,logon,thermalzone,tcp -
Verify that the exporter works properly by accessing http://localhost:9182/
Netdata also supports the process and service collectors, which by defaults expose metrics about all processes and services in the system. This can result in thousands of time series and can significantly increase CPU usage. It is recommended to use filtering flags (process, service) to keep down the number of returned metrics.
For example:
msiexec -i <path-to-msi-file> ENABLED_COLLECTORS=cpu,memory,net,logical_disk,os,system,logon,thermalzone,tcp,process EXTRA_FLAGS="--collector.process.whitelist=""(firefox|FIREFOX|chrome).*"" --collector.service.services-where ""Name LIKE 'sql%'"""
More installation options can be found in the windows_exporter official installation guide.
Metrics
All metrics have "wmi." prefix.
| Metric | Scope | Dimensions | Units |
|---|---|---|---|
| cpu_utilization_total | global | dpc, user, privileged, interrupt | percentage |
| cpu_dpcs | global | a dimension per core | dpcs/s |
| cpu_interrupts | global | a dimension per core | interrupts/s |
| cpu_utilization | cpu core | dpc, user, privileged, interrupt | percentage |
| cpu_cstate | cpu core | c1, c2, c3 | percentage |
| memory_utilization | global | available, used | KiB |
| memory_page_faults | global | page_faults | events/s |
| memory_swap_utilization | global | available, used | KiB |
| memory_swap_operations | global | read, write | operations/s |
| memory_swap_pages | global | read, written | pages/s |
| memory_cached | global | cached | KiB |
| memory_cache_faults | global | cache_faults | events/s |
| memory_system_pool | global | paged, non-paged | KiB |
| net_bandwidth | network device | received, sent | kilobits/s |
| net_packets | network device | received, sent | packets/s |
| net_errors | network device | inbound, outbound | errors/s |
| net_discarded | network device | inbound, outbound | discards/s |
| logical_disk_utilization | logical disk | free, used | KiB |
| logical_disk_bandwidth | logical disk | read, write | KiB/s |
| logical_disk_operations | logical disk | reads, writes | operations/s |
| logical_disk_latency | logical disk | read, write | milliseconds |
| os_processes | global | processes | number |
| os_users | global | users | users |
| os_visible_memory_usage | global | free, used | bytes |
| os_paging_files_usage | global | free, used | bytes |
| system_threads | global | threads | number |
| system_uptime | global | time | seconds |
| logon_type_sessions | global | system, interactive, network, batch, service, proxy, unlock, network_clear_text, new_credentials, remote_interactive, cached_interactive, cached_remote_interactive, cached_unlock | seconds |
| thermalzone_temperature | global | a dimension per thermalzone | celsius |
| tcp_conns_established | global | ipv4, ipv6 | connections |
| tcp_conns_active | global | ipv4, ipv6 | connections/s |
| tcp_conns_passive | global | ipv4, ipv6 | connections/s |
| tcp_conns_failures | global | ipv4, ipv6 | failures/s |
| tcp_conns_resets | global | ipv4, ipv6 | resets/s |
| tcp_segments_received | global | ipv4, ipv6 | segments/s |
| tcp_segments_sent | global | ipv4, ipv6 | segments/s |
| tcp_segments_retransmitted | global | ipv4, ipv6 | segments/s |
| processes_cpu_time | global | a dimension per process | percentage |
| processes_handles | global | a dimension per process | handles |
| processes_io_bytes | global | a dimension per process | bytes/s |
| processes_io_operations | global | a dimension per process | operations/s |
| processes_page_faults | global | a dimension per process | pgfaults/s |
| processes_page_file_bytes | global | a dimension per process | bytes |
| processes_pool_bytes | global | a dimension per process | bytes |
| processes_threads | global | a dimension per process | threads |
| service_state | service | running, stopped, start_pending, stop_pending, continue_pending, pause_pending, paused, unknown | state |
| service_status | service | ok, error, unknown, pred_fail, starting, stopping, service, stressed, nonrecover, no_contact, lost_comm | status |
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.ddirectory, usually at/usr/libexec/netdata/plugins.d/. If that's not the case on your system, opennetdata.confand look for thepluginssetting under[directories].cd /usr/libexec/netdata/plugins.d/ -
Switch to the
netdatauser.sudo -u netdata -s -
Run the
go.d.pluginto debug the collector:./go.d.plugin -d -m wmi
Documentation
Source Files