windows_exporter

command module
v0.4.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 3, 2018 License: MIT Imports: 15 Imported by: 0

README

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)
hyperv Performance counters for Hyper-V hosts
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)
msmq Win32_PerfRawData_MSMQ_MSMQQueue metrics (MSMQ/journal count)
mssql various SQL Server Performance Objects metrics
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)
tcp Win32_PerfRawData_Tcpip_TCPv4 metrics (tcp connections)
textfile Read prometheus metrics from a text file
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
TEXTFILE_DIR As the --collector.textfile.directory flag, provide a directory to read text files with metrics from

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/golang/dep
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

Enable only service collector and specify a custom query
.\wmi_exporter.exe --collectors.enabled "service" --collector.service.services-where "Name='wmi_exporter'"
Enable only process collector and specify a custom query
.\wmi_exporter.exe --collectors.enabled "process" --collector.process.processes-where "Name LIKE 'firefox%'"

When there are multiple processes with the same name, WMI represents those after the first instance as process-name#index. So to get them all, rather than just the first one, the query needs to be a wildcard search.

License

Under MIT

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
returns data points from Win32_PerfRawData_DirectoryServices_DirectoryServices Partial docs: https://msdn.microsoft.com/en-us/library/ms803980.aspx returns data points from Win32_PerfRawData_PerfOS_Processor https://msdn.microsoft.com/en-us/library/aa394317(v=vs.90).aspx - Win32_PerfRawData_PerfOS_Processor class returns data points from Win32_PerfRawData_DNS_DNS https://msdn.microsoft.com/en-us/library/ms803992.aspx?f=255&MSPPError=-2147217396 https://technet.microsoft.com/en-us/library/cc977686.aspx returns data points from Win32_PerfRawData_MSMQ_MSMQQueue <add link to documentation here> - Win32_PerfRawData_MSMQ_MSMQQueue class returns data points from Win32_PerfRawData_NETFramework_NETCLRExceptions <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRExceptions class returns data points from Win32_PerfRawData_NETFramework_NETCLRInterop <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRInterop class returns data points from Win32_PerfRawData_NETFramework_NETCLRJit <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRJit class returns data points from Win32_PerfRawData_NETFramework_NETCLRLoading <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRLoading class returns data points from Win32_PerfRawData_NETFramework_NETCLRLocksAndThreads <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRLocksAndThreads class returns data points from Win32_PerfRawData_NETFramework_NETCLRMemory <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRMemory class returns data points from Win32_PerfRawData_NETFramework_NETCLRRemoting <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRRemoting class returns data points from Win32_PerfRawData_NETFramework_NETCLRSecurity <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRSecurity class returns data points from Win32_PerfRawData_PerfProc_Process https://msdn.microsoft.com/en-us/library/aa394323(v=vs.85).aspx - Win32_PerfRawData_PerfProc_Process class returns data points from Win32_Service https://msdn.microsoft.com/en-us/library/aa394418(v=vs.85).aspx - Win32_Service class returns data points from Win32_PerfRawData_vmGuestLib_VMem and Win32_PerfRawData_vmGuestLib_VCPU
returns data points from Win32_PerfRawData_DirectoryServices_DirectoryServices Partial docs: https://msdn.microsoft.com/en-us/library/ms803980.aspx returns data points from Win32_PerfRawData_PerfOS_Processor https://msdn.microsoft.com/en-us/library/aa394317(v=vs.90).aspx - Win32_PerfRawData_PerfOS_Processor class returns data points from Win32_PerfRawData_DNS_DNS https://msdn.microsoft.com/en-us/library/ms803992.aspx?f=255&MSPPError=-2147217396 https://technet.microsoft.com/en-us/library/cc977686.aspx returns data points from Win32_PerfRawData_MSMQ_MSMQQueue <add link to documentation here> - Win32_PerfRawData_MSMQ_MSMQQueue class returns data points from Win32_PerfRawData_NETFramework_NETCLRExceptions <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRExceptions class returns data points from Win32_PerfRawData_NETFramework_NETCLRInterop <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRInterop class returns data points from Win32_PerfRawData_NETFramework_NETCLRJit <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRJit class returns data points from Win32_PerfRawData_NETFramework_NETCLRLoading <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRLoading class returns data points from Win32_PerfRawData_NETFramework_NETCLRLocksAndThreads <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRLocksAndThreads class returns data points from Win32_PerfRawData_NETFramework_NETCLRMemory <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRMemory class returns data points from Win32_PerfRawData_NETFramework_NETCLRRemoting <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRRemoting class returns data points from Win32_PerfRawData_NETFramework_NETCLRSecurity <add link to documentation here> - Win32_PerfRawData_NETFramework_NETCLRSecurity class returns data points from Win32_PerfRawData_PerfProc_Process https://msdn.microsoft.com/en-us/library/aa394323(v=vs.85).aspx - Win32_PerfRawData_PerfProc_Process class returns data points from Win32_Service https://msdn.microsoft.com/en-us/library/aa394418(v=vs.85).aspx - Win32_Service class returns data points from Win32_PerfRawData_vmGuestLib_VMem and Win32_PerfRawData_vmGuestLib_VCPU
tools

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL