Go to file
Martin Lindhe 94caf8ee61 correct help message, fixes #118. typo was introduced in a66f0b5475 2017-09-07 14:28:27 +02:00
collector Fix "no where-clause" warning in service collector 2017-08-11 17:38:06 +02:00
installer Add DisplayName and Description to Windows service (#100) 2017-08-10 02:13:32 +02:00
tools/collector-generator Add support for generating collectors from remote systems 2017-03-03 14:55:11 +01:00
vendor Fix memory leak by updating go-ole and adding wbem initialization (#82) 2017-06-26 21:03:17 +02:00
.gitignore Setup GitVersion 2016-10-18 16:37:30 +02:00
.promu.yml add boilerplate for promu 2016-09-30 08:31:19 +02:00
AUTHORS.md AUTHORS.md 2016-09-19 09:06:26 +02:00
LICENSE add perf collector, exposing Win32_PerfRawData_PerfDisk_LogicalDisk 2016-08-26 11:08:12 +02:00
Makefile Makefile: add build command 2017-08-10 01:32:54 +02:00
README.md Merge pull request #107 from martinlindhe/doc-process 2017-08-11 12:55:34 +02:00
appveyor.yml Fix arch name typo 2016-12-25 07:55:42 +01:00
exporter.go correct help message, fixes #118. typo was introduced in a66f0b5475 2017-09-07 14:28:27 +02:00
exporter_test.go Add [defaults] placeholder support to collectors.enabled 2017-03-04 12:44:47 +01:00

README.md

WMI exporter

Build status

Prometheus exporter for Windows machines, using the WMI (Windows Management Instrumentation).

Collectors

Name Description Enabled by default
ad Win32_PerfRawData_DirectoryServices_DirectoryServices Active Directory
cpu Win32_PerfRawData_PerfOS_Processor metrics (cpu usage)
cs Win32_ComputerSystem metrics (system properties, num cpus/total memory)
dns Win32_PerfRawData_DNS_DNS metrics (DNS Server)
iis Win32_PerfRawData_W3SVC_WebService IIS metrics
logical_disk Win32_PerfRawData_PerfDisk_LogicalDisk metrics (disk I/O)
net Win32_PerfRawData_Tcpip_NetworkInterface metrics (network interface I/O)
os Win32_OperatingSystem metrics (memory, processes, users)
process Win32_PerfRawData_PerfProc_Process metrics (per-process stats)
service Win32_Service metrics (service states)
system Win32_PerfRawData_PerfOS_System metrics (system calls)
vmware Performance counters installed by the Vmware Guest agent

The HELP texts shows the WMI data source, please see MSDN documentation for details.

Installation

The latest release can be downloaded from the releases page.

Each release provides a .msi installer. The installer will setup the WMI Exporter as a Windows service, as well as create an exception in the Windows Firewall.

If the installer is run without any parameters, the exporter will run with default settings for enabled collectors, ports, etc. The following parameters are available:

Name Description
ENABLED_COLLECTORS As the -collectors.enabled flag, provide a comma-separated list of enabled collectors
LISTEN_ADDR The IP address to bind to. Defaults to 0.0.0.0
LISTEN_PORT The port to bind to. Defaults to 9182.
METRICS_PATH The path at which to serve metrics. Defaults to /metrics

Parameters are sent to the installer via msiexec. Example invocation:

msiexec /i <path-to-msi-file> ENABLED_COLLECTORS=os,iis LISTEN_PORT=5000

Roadmap

See open issues

Usage

go get -u github.com/kardianos/govendor
go get -u github.com/prometheus/promu
go get -u github.com/martinlindhe/wmi_exporter
cd $env:GOPATH/src/github.com/martinlindhe/wmi_exporter
promu build -v .
.\wmi_exporter.exe

The prometheus metrics will be exposed on localhost:9182

Examples

Please note: The quotes in the parameter names are required because of how Powershell parses command line arguments.

Enable only service collector and specify a custom query

.\wmi_exporter.exe "-collectors.enabled" "service" "-collector.service.services-where" "Name='wmi_exporter'"

Examples

Please note: The quotes in the parameter names are required because of how Powershell parses command line arguments.

Enable only process collector and specify a custom query

.\wmi_exporter.exe "-collectors.enabled" "process" "-collector.process.processes-where" "Name='firefox'"

License

Under MIT