WARNING: Version 6.2 of Metricbeat has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Windows perfmon metricset
editWindows perfmon metricset
editThis functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.
The perfmon metricset of the Windows module reads Windows
performance counters.
Configuration
editYou must configure queries for the Windows performance counters that you wish
to collect. The example below collects processor time and disk writes.
With format you can set the output format for a specific counter. Possible values are
float and long. If nothing is selected the default value is float.
With instance_name, you can specify the name of the instance. Use this setting when:
- You want to use an instance name that is different from the computed name. For example, Total instead of _Total.
- You specify a counter that has no instance. For example, \TCPIP Performance Diagnostics\IPv4 NBLs/sec indicated without prevalidation.
For wildcard queries this setting has no effect.
- module: windows
metricsets: ["perfmon"]
period: 10s
perfmon.counters:
- instance_label: "processor.name"
instance_name: "Total"
measurement_label: "processor.time.total.pct"
query: '\Processor Information(_Total)\% Processor Time'
- instance_label: "diskio.name"
measurement_label: "diskio.write.bytes"
query: '\PhysicalDisk(*)\Disk Writes/sec'
format: "long"
Fields
editFor a description of each field in the metricset, see the exported fields section.
Here is an example document generated by this metricset:
{
"@timestamp": "2016-05-23T08:05:34.853Z",
"beat": {
"hostname": "host.example.com",
"name": "host.example.com"
},
"metricset": {
"module": "windows",
"name": "perfmon",
"rtt": 115
},
"type": "metricsets",
"windows": {
"perfmon": {
"disk": {
"bytes": {
"read": {
"total": 0
}
}
},
"processor": {
"time": {
"idle": {
"average": {
"ns": 670661.5894039735
}
},
"total": {
"pct": 3.135058464112306
}
}
}
}
}
}