Skip to main content

Windows WSMAN

Pack Assets​

Templates​

The Centreon Plugin Pack Windows WSMAN brings 1 host template:

  • OS-Windows-WSMAN-custom

It brings the following service templates:

Service AliasService TemplateService DescriptionDefaultDiscovery
CpuOS-Windows-Cpu-WSMANCheck the rate of utilization of CPU for the machine. This check can give the average CPU utilization rate and the rate per CPU for multi-core CPUs.X
Disk-GlobalOS-Windows-Disk-Global-WSMANCheck the rate of free space on the disk. For each checks the name of the disk will appearX
Files-Date-GenericOS-Windows-Files-Date-Generic-WSMANCheck time
Files-Size-GenericOS-Windows-Files-Size-Generic-WSMANCheck size of files
MemoryOS-Windows-Memory-WSMANCheck the rate of the utilization of memoryX
NtpOS-Windows-Ntp-WSMANCheck the synchronization with an NTP server
Pending-RebootOS-Windows-Pending-Reboot-WSMANCheck windows pending reboot
Process-GlobalOS-Windows-Process-Global-WSMANCheck if Windows processes are startedX
Service-GenericOS-Windows-Service-Generic-WSMANCheck if Windows services are startedX
Services-AutoOS-Windows-Services-Auto-WSMANCheck if Windows services are startedX
SessionsOS-Windows-Sessions-WSMANCheck Windows user sessions
SwapOS-Windows-Swap-WSMANCheck the rate of the utilization of virtual memoryX
Traffic-GlobalOS-Windows-Traffic-Global-WSMANCheck the bandwidth of the interface. For each checks the name of the interface will appearX
UptimeOS-Windows-Uptime-WSMANCheck the uptime of the Windows server since the last reboot. It's just an indication with no threshold

Discovery rules​

Rule NameDescription
OS-Windows-WSMAN-Disk-NameDiscover the disk partitions and monitor space occupation
OS-Windows-WSMAN-Processes-NameDiscover processes and monitor their system usage
OS-Windows-WSMAN-Services-NameDiscover services and monitor their system usage
OS-Windows-WSMAN-Traffic-NameDiscover network interfaces and monitor bandwidth utilization

Collected metrics & status​

Metric NameUnit
cpu.utilization.percentage%
cpu_core#core.cpu.utilization.percentage%

Prerequisites​

To monitor Windows Servers through WSMAN, please follow our official documentation and make sure that WinRM and all rights are properly configured.

Setup​

  1. Install the Centreon plugin package on every Centreon poller expected to monitor Windows WSMAN resources:

    yum install centreon-plugin-Operatingsystems-Windows-Wsman
  2. On the Centreon web interface, install the Windows WSMAN Centreon Plugin Pack on the Configuration > Plugin Packs page.

Configuration​

Host​

  • Log into Centreon and add a new host through Configuration > Hosts.
  • Fill the Name, Alias and IP Address/DNS fields according to your Windows WSMAN server's settings.
  • Apply the OS-Windows-WSMAN-custom template to the host.
  • Once the template is applied, fill in the corresponding macros. Some macros are mandatory.
MandatoryMacroDescription
WSMANEXTRAOPTIONSAny extra option you may want to add to every command line (eg. a --verbose flag)
WSMANPASSWORD
WSMANPORT5985
WSMANPROTOhttp
WSMANUSERNAME

How to check in the CLI that the configuration is OK and what are the main options for?​

Once the plugin is installed, log into your Centreon Poller's CLI using the centreon-engine user account (su - centreon-engine) and test the plugin by running the following command:

/usr/lib/centreon/plugins//centreon_windows_wsman.pl \
--plugin=os::windows::wsman::plugin \
--mode=uptime \
--hostname=10.0.0.1 \
--wsman-scheme=http \
--wsman-port=5985 \
--wsman-username='' \
--wsman-password='' \
--warning='' \
--critical='' \
--use-new-perfdata

The expected command output is shown below:

OK:  | System uptime is: 53m 15s | 'system.uptime.seconds'=3195s;;;0;

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_windows_wsman.pl \
--plugin=os::windows::wsman::plugin \
--mode=uptime \
--help

All available options for a given mode can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_windows_wsman.pl \
--plugin=os::windows::wsman::plugin \
--list-mode

Troubleshooting​

Please find all the troubleshooting documentation for the Centreon Plugins in the dedicated page.