We use cookies to ensure that we give you the best experience on our website.  Visit our Privacy Policy to learn more. If you continue to use this site, we will assume that you are okay with it.

Your choices regarding cookies on this site.
Your preferences have been updated.
In order for the changes to take effect completely please clear your browser cookies and cache. Then reload the page.

Check manual page of winperf_if

Checkmk Manual

On this page

Search in the manual

Windows: State and Performance of Network Interfaces

Distribution: official part of Check_MK
License: GPL
Supported Agents: Windows

This check monitors the operational status, link speed, traffic, packet counts, discards and errors of network interfaces of a Windows host using data sent by the Checkmk agent.

In order to get information about the link status and MAC address you need to deploy the agent plugin wmic_if.bat into the plugins directory of your Checkmk agent for Windows. On servers with just one network interface you probably won't need the information about the link status, since the agent will be unreachable anyway if the status is not up. We propose to not installing the plugin in that case and save a few CPU resources.

The plugin "mk_dhcp_enabled.bat" can be used to get a WARN if the ip address of the interface was assigned by dhcp.

The interface index (in SNMP known as ifIndex) is simulated by creating an artificial running index after sorting the names of the interfaces alphabetically.

All other aspects of this check are completely compatible of if. Please refer to that man page for further information.

To check the current state of Windows bonding interfaces you need to install the agent plugin windows_if.ps1 on the target host.


See man page of if for details


One service is created for each port that fulfills configurable conditions.

See man page of if for details