Skip to main content

Microsoft SCCM

Overview​

Microsoft Endpoint Configuration Manager, formely knwown as System Center Configuration Manager or SCCM, is a systems management software product developed by Microsoft for managing large groups of computers running Windows NT, Windows Embedded, macOS (OS X), Linux or UNIX, as well as Windows Phone, Symbian, iOS and Android mobile operating systems. Configuration Manager provides remote control, patch management, software distribution, operating system deployment, network access protection and hardware and software inventory.

The Centreon Monitoring Connector allows to gather information and status about the SCCM service using the centreon-nsclient agent. Both connection methods NRPE and RestAPI are supported.

Monitoring Connector assets​

Monitored objects​

  • Database replication
  • Sites

Collected metrics​

Metric nameDescription
link-statusStatus of the replication link
site-statusStatus of the site replication

Prerequisites​

Centreon NSClient++​

The Windows SCCM Plugin is hosted by the centreon-nsclient agent which must be installed, configured and running on the Windows server running the SCCM Admin console.

The Centreon Poller can connect to the agent using either the NRPE method or the RestAPI method. More information on how to achieve the installation and the configuration of the agent can be found here

Installation​

  1. Depending on the monitoring method chosen (NRPE or RestAPI), install the relevant Centreon package on every Centreon Poller expected to monitor SCCM through centreon-nsclient:
  • NRPE
yum install centreon-nrpe-plugin
  • RestAPI
yum install centreon-plugin-Operatingsystems-Windows-Restapi
  1. On the Centreon Web interface, install the Microsoft SCCM Centreon Pack from the Configuration > Monitoring Connector Manager page

Host configuration​

  • On the Centreon Web Interface, go to Configuration > Hosts and add a new Host
  • Set the Host IP address and select the relevant Host template according to the monitoring method chosen:
    • App-Sccm-NRPE-custom for NRPE
    • App-Sccm-NSClient-05-Restapi-custom for RestAPI
  • Depending on the Host template, fill the Macro fields as follows:
MandatoryNameDescription
XNRPECLIENTNRPE Plugin binary to use (Default: 'check_centreon_nrpe')
XNRPEPORTNRPE Port of the target server (Default: '5666')
XNRPETIMEOUTTimeout value (Default: '30')
NRPEEXTRAOPTIONSAny extra option you may want to add to every command_line (Default: '-u -m 8192')

Click on the Save button.

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

Once the plugin installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command:

/usr/lib64/nagios/plugins/check_centreon_nrpe \
    -H 10.0.0.1 \
    -p 5666 \
    -t 30 \
    -u -m 8192 \
    -c check_centreon_plugins -a 'apps::sccm::local::plugin' 'site-status' '--critical-status="%{status} eq FAILED"'

This command should return an output message like:

OK: Site 'MySite' status is 'ACTIVE' [Type: PRIMARY] [Mode: 'Unknown'] |

The command above connects to a centreon-nsclient agent using the NRPE protocol (/usr/lib64/nagios/plugins/check_centreon_nrpe) along with the related connections settings defined in the Host Macros (-p 5666 -t 30 -u -m 8192). The centreon-nsclient agent is requested to locally execute the site-status mode of the SCCM Plugin (-c check_centreon_plugins -a 'apps::sccm::local::plugin' 'site-status'). This command would trigger a CRITICAL alarm if the reported status of the SCCM site is FAILED (--critical-status="%{status} eq FAILED").

All the available thresholds and options of the mode can be displayed by adding the --help parameter to the command:

/usr/lib64/nagios/plugins/check_centreon_nrpe -c check_centreon_plugins -a 'apps::sccm::local::plugin' 'site-status' '--help'