Skip to main content

Microsoft WSUS Server

Pack Assets​

Templates​

The Centreon Plugin Pack Microsoft WSUS brings 2 different host templates:

  • App-Wsus-NRPE-custom
  • App-Wsus-NSClient-05-Restapi-custom

They bring the following service templates:

Service AliasService TemplateService DescriptionDefault
Computers-StatusApp-Wsus-Computers-Status-NRPECheck computers status countX
Server-StatisticsApp-Wsus-Server-Statistics-NRPECheck serveral WSUS server statisticsX
Synchronisation-StatusApp-Wsus-Synchronisation-Status-NRPECheck updates synchronisation with WSUS server statusX
Update-StatusApp-Wsus-Update-Status-NRPECheck updates statusX

Collected metrics & status​

Metric NameUnit
needing-updates
not-contacted
unassigned
up-to-date
with-update-errors

Prerequisites​

Centreon NSClient++​

To monitor a WSUS Server through NSClient++ API, install the Centreon packaged version of the NSClient++ agent. Please follow our official documentation and make sure that the NRPE Server configuration is correct.

Setup​

Monitoring Pack​

If the platform uses an online license, you can skip the package installation instructions below as it is not required in order to have the pack displayed within the Configuration > Plugin Packs > Manager menu.

If you want to use the NRPE host template, please install centreon-nrpe3 package.

If the platform uses an offline license, install the package on the central server with the command corresponding to the operating system's package manager:

dnf install centreon-pack-applications-wsus-nsclient

Whatever the license type (online or offline), install the Microsoft WSUS Pack through the Configuration > Plugin Packs > Manager menu.

Plugin​

Use the commands below according to your operating system's package manager:

dnf install centreon-nrpe3-plugin

Configuration​

Host​

  • Log into Centreon and add a new host through Configuration > Hosts.
  • Fill the Name, Alias & IP Address/DNS fields according to your WSUS Server server settings.
  • Apply the chosen template to the host: App-Wsus-NRPE-custom or App-Wsus-NSClient-05-Restapi-custom.
  • Depending on the Host template, fill the Macro fields as follows:
MandatoryMacroDescription
NRPECLIENTRecommend check_centreon_nrpe3 (Default: 'check_centreon_nrpe')
NRPEEXTRAOPTIONS-u -m 8192
NRPEPORT(Default: '5666')
NRPETIMEOUT(Default: '55')
WSUSPORTWSUS Server port
WSUSSERVERWSUS Server name

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

The following examples come for the RestAPI template.

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_nsclient_restapi.pl \
    --plugin=apps::nsclient::restapi::plugin \
    --mode=query \
    --hostname=10.0.0.1 \
    --port='' \
    --proto='' \
    --legacy-password='' \
    --command=check_centreon_plugins \
    --arg='apps::microsoft::wsus::local::plugin' \
    --arg='server-statistics' \
    --arg=' \
    --wsus-server="my.wsus.server.domain" \
    --wsus-port="443" \
    --filter-counters="" \
    --warning-computers="" \
    --critical-computers="" \
    --warning-computer-groups="" \
    --critical-computer-groups="" \
    --warning-updates="" \
    --critical-updates="" \
    --warning-approved-updates="" \
    --critical-approved-updates="" \
    --warning-declined-updates="" \
    --critical-declined-updates=""\
    --warning-not-approved-updates="" \
    --critical-declined-updates="" \
    --warning-stale-updates="" \
    --critical-stale-updates="" \
    --warning-expired-updates="" \
    --critical-expired-updates="" \
    --verbose'\
    --use-new-perfdata

The expected command output is shown below:

OK: Computers: 120 Computer Groups: 6 Updates: 19 Approved Updates: 3 Declined Updates: 14 Not Approved Updates: 22 Stale Updates: 1 Expired Updates: 5 |

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

/usr/lib/centreon/plugins//centreon_nsclient_restapi.pl \
    --plugin=apps::nsclient::restapi::plugin \
    --mode=query \
    --help

All available modes can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_nsclient_restapi.pl \
    --plugin=apps::nsclient::restapi::plugin \
    --list-mode

Troubleshooting​

Please find the troubleshooting documentation here for Centreon Plugins typical issues.