Microsoft WSUS
Contenu du Pack​
Modèles​
Le connecteur de supervision Centreon Microsoft WSUS apporte 2 modèles d'hôte différents :
- App-Wsus-NRPE-custom
- App-Wsus-NSClient-05-Restapi-custom
Ils apportent les modèles de service suivants:
- App-Wsus-NRPE-custom
- App-Wsus-NSClient-05-Restapi-custom
Alias | Modèle de service | Description | Défaut |
---|---|---|---|
Computers-Status | App-Wsus-Computers-Status-NRPE | Contrôle le nombre d'ordinateurs dans chacun des statuts via NRPE | X |
Server-Statistics | App-Wsus-Server-Statistics-NRPE | Contrôle plusieurs statistiques du serveur WSUS via NRPE | X |
Synchronisation-Status | App-Wsus-Synchronisation-Status-NRPE | Contrôle la synchronisation des mises à jour avec le serveur WSUS via NRPE | X |
Update-Status | App-Wsus-Update-Status-NRPE | Contrôle le statut des mises à jour via NRPE | X |
Alias | Modèle de service | Description | Défaut |
---|---|---|---|
Computers-Status | App-Wsus-Computers-Status-NSClient05-Restapi | Contrôle le nombre d'ordinateurs dans chacun des statuts via l'API | X |
Server-Statistics | App-Wsus-Server-Statistics-NSClient05-Restapi | Contrôle plusieurs statistiques du serveur WSUS via l'API | X |
Synchronisation-Status | App-Wsus-Synchronisation-Status-NSClient05-Restapi | Contrôle la synchronisation des mises à jour avec le serveur WSUS via l'API | X |
Update-Status | App-Wsus-Update-Status-NSClient05-Restapi | Contrôle le statut des mises à jour via l'API | X |
Métriques & statuts collectés​
- Computers-Status
- Server-Statistics
- Synchronisation-Status
- Update-Status
Métrique | Unité |
---|---|
needing-updates | |
not-contacted | |
unassigned | |
up-to-date | |
with-update-errors |
Métrique | Unité |
---|---|
approved-updates | |
computer-groups | |
computers | |
declined-updates | |
expired-updates | |
not-approved-updates | |
stale-updates | |
updates |
Métrique | Unité |
---|---|
synchronisation-progress | |
synchronisation-status | |
last-synchronisation-duration | |
last-synchronisation-status |
Métrique | Unité |
---|---|
needed-by-computers | |
needing-files | |
up-to-date | |
with-client-errors | |
with-server-errors |
Prérequis​
Centreon NSClient++​
- App-Wsus-NRPE-custom
- App-Wsus-NSClient-05-Restapi-custom
Pour surveiller les ressources WSUS Server via NRPE, installez la version Centreon de l'agent NSClient++. Veuillez suivre notre documentation officielle et assurez-vous que le serveur NRPE embarqué est correctement configuré.
Pour surveiller les ressources WSUS Server via NSClient++ API, installez la version Centreon de l'agent NSClient++. Veuillez suivre notre documentation officielle et assurez-vous que la configuration du serveur Web / RestAPI est correcte.
Installation​
Pack de supervision​
Si la plateforme est configurée avec une licence online, l'installation d'un paquet n'est pas requise pour voir apparaître le pack dans le menu Configuration > Gestionnaire de connecteurs de supervision.
Si vous souhaitez utiliser le modèle d'hôte NRPE, installez le paquet centreon-nrpe3.
Au contraire, si la plateforme utilise une licence offline, installez le paquet sur le serveur central via la commande correspondant au gestionnaire de paquets associé à sa distribution :
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian 11 & 12
dnf install centreon-pack-applications-wsus-nsclient
yum install centreon-pack-applications-wsus-nsclient
apt install centreon-pack-applications-wsus-nsclient
Quel que soit le type de la licence (online ou offline), installez le Pack Microsoft WSUS depuis l'interface web et le menu Configuration > Gestionnaire de connecteurs de supervision.
Plugin​
Utilisez les commandes ci-dessous en fonction du gestionnaire de paquets de votre système d'exploitation :
- Alma / RHEL / Oracle Linux 8
- CentOS 7
- Debian 11 & 12
dnf install centreon-nrpe3-plugin
yum install centreon-nrpe3-plugin
yum install centreon-plugin-Operatingsystems-Windows-Restapi
apt install centreon-nrpe3-plugin
apt install centreon-plugin-operatingsystems-windows-restapi
Configuration​
Hôte​
- Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes.
- Complétez les champs Nom, Alias & IP Address/DNS correspondant à votre serveur WSUS Server.
- Appliquez le modèle d'hôte de votre choix: App-Wsus-NRPE-custom ou App-Wsus-NSClient-05-Restapi-custom.
- Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
- App-Wsus-NRPE-custom
- App-Wsus-NSClient-05-Restapi-custom
Obligatoire | Macro | Description |
---|---|---|
NRPECLIENT | (Défaut : 'check_centreon_nrpe') | |
NRPEEXTRAOPTIONS | Options spécifiques à NRPE (Défaut: -u -m 8192) | |
NRPEPORT | Port d'écoute du serveur NRPE (Défaut : '5666') | |
NRPETIMEOUT | Timeout (Défaut : '55') | |
X | WSUSPORT | Port d'écoute sur serveur WSUS |
X | WSUSSERVER | Nom/FQDN du serveur WSUS |
Obligatoire | Macro | Description |
---|---|---|
NSCPRESTAPIEXTRAOPTIONS | Options supplémentaires à ajouter à l'ensemble des commandes de l'hôte (ex: --verbose) | |
NSCPRESTAPILEGACYPASSWORD | Mot de passe pour l'authentification basique de l'API | |
NSCPRESTAPIPORT | Port d'écoute de l'API | |
NSCPRESTAPIPROTO | Protocole de l'API | |
X | WSUSPORT | Port d'écoute sur serveur WSUS |
X | WSUSSERVER | Nom/FQDN du serveur WSUS |
Comment puis-je tester le plugin et que signifient les options des commandes ?​
Les exemples suivants sont donnés pour le modèle RestAPI.
Une fois le plugin installé, vous pouvez tester celui-ci directement en ligne
de commande depuis votre collecteur Centreon en vous connectant avec
l'utilisateur centreon-engine (su - centreon-engine
) :
/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
La commande devrait retourner un message de sortie similaire à :
OK: Computers: 120 Computer Groups: 6 Updates: 19 Approved Updates: 3 Declined Updates: 14 Not Approved Updates: 22 Stale Updates: 1 Expired Updates: 5 |
La liste de toutes les options complémentaires et leur signification peut être
affichée en ajoutant le paramètre --help
à la commande :
/usr/lib/centreon/plugins//centreon_nsclient_restapi.pl \
--plugin=apps::nsclient::restapi::plugin \
--mode=query \
--help
Tous les modes disponibles peuvent être affichés en ajoutant le paramètre
--list-mode
à la commande :
/usr/lib/centreon/plugins//centreon_nsclient_restapi.pl \
--plugin=apps::nsclient::restapi::plugin \
--list-mode
Diagnostic des erreurs communes​
Rendez-vous sur la documentation dédiée pour le diagnostic des erreurs communes des plugins Centreon.