Aller au contenu principal

Centreon NSClient++

Introduction​

NSClient++ est un agent de supervision Open Source multi plateformes utilisable sur les environnements Microsoft Windows et Linux. Il permet l'exécution locale de commandes personnalisées et l'utilisation de protocoles de supervision standards : NRPE, NSCA, HTTPS. Cet agent vise à fournir un ensemble exhaustif d'indicateurs, tant au niveau système qu'au niveau applicatif.

Centreon fournit une version recompilée et personnalisée prête à l'emploi de l'agent tout simplement baptisée centreon-nsclient. Cette version permet de profiter des fonctionnalités natives de NSClient++ combinées à la puissance des Plugins Centreon, permettant ainsi la supervision d'indicateurs applicatifs tels que Hyper-V, Active Directory, WSUS, SCCM, Microsoft Exchange, Veeam et bien d'autres.

Les Plugins Centreon issus du projet centreon-plugins sont spécialement recompilés et packagés pour une utilisation sous Windows. Ils sont directement déployés et prêts à l'emploi lors de l'installation de l'agent centreon-nsclient sous la forme d'un exécutable nommé centreon_plugins.exe.

Retrouvez la liste des connecteurs de supervision compatibles avec l'agent centreon-nsclient sur le catalogue officiel Centreon

La procédure suivante vous permettra de comprendre le fonctionnement, l'installation et l'exploitation de l'agent centreon-nsclient sur vos serveurs Windows.

Support et mises à jour​

Centreon supporte et maintient uniquement les Plugins personnalisés fournis au travers de l'agent centreon-nsclient. Pour toute question ou problème relatif au fonctionnement de NSClient++, rendez-vous sur la documentation officielle de NSClient++.

Centreon publiera une version mensuelle des exécutables centreon_plugins.exe et check_logfiles comprenant les dernières nouveautés ainsi que les bugfixes. L'installateur de l'agent centreon-nsclient est également mis à jour et proposé dans sa dernière version pour les nouvelles installations.

Pour la mise à jour des Plugins Centreon integrés à l'agent centreon-nsclient, consultez le chapitre Mise à Jour

Téléchargement​

Tout d'abord, rendez-vous sur la page Github du projet centreon-nsclient et récupérez les dernières versions des exécutables détaillés ci-dessous en fonction de votre environnement (x86 ou x64):

  • pour une nouvelle installation de l'agent, tĂ©lĂ©chargez le package d'installation Centreon-NSClient-0.5.x.xx-YYYYMMDD
  • pour une mise Ă  jour des Plugins custom, tĂ©lĂ©chargez les binaires centreon_plugins_YYYYMMDD_*\*\*_.exe & check_logfiles_x.x.x_\*\*\*.exe

Installation​

Cette section concerne une nouvelle installation de l'agent centreon-nsclient.

Lancez l'installation de l'agent centreon-nsclient et suivez l'assistant :

  • La première Ă©tape vous informe sur NSClient++, sa version et sa date de publication. Appuyez sur Suivant pour passer Ă  la deuxième Ă©tape :

image

  • Choisissez le dossier d'installation et cliquez sur Suivant :

image

  • Attendez la fin de l'installation :

image

  • Une fois l'installation terminĂ©e, vous pouvez cliquer sur Suivant :

image

  • L'assistant d'installation confirme le succès de l'installation et vous pouvez cliquer sur Terminer :

image

Mise à Jour​

Cette section concerne la mise à jour des exécutables centreon_plugins.exe et check_logfiles sur une installation existante.

Lors des nouvelles releases mensuelles, il n'est pas nécessaire de réinstaller complètement l'agent, seul les Plugins packagés peuvent être mis à jour.

Pour cela, rendez-vous dans le dossier contenant les scripts centreon_plugins.exe et check_logfiles.exe (généralement C:\Program Files\Centreon NSClient++\scripts\centreon et remplacez les exécutables par les dernières versions téléchargées sur Github (voir le chapitre Installation).

image

Remarque N'oubliez pas de renommer les fichiers en supprimant les numéros de version des téléchargements (le fichiers doivent être impérativement nommés centreon_plugins.exe et check_logfiles.exe)

Configuration​

La configuration générale de l'agent, des modules et des commandes appelées est centralisée dans le fichier nsclient.ini, généralement présent dans le répertoire C:\Program Files\Centreon NSClient++\.

image

La configuration par défaut permet une utilisation immédiate de la plupart des fonctionnalités. Il est cependant recommandé d'ajuster certains paramètres, notamment pour des raisons de sécurité.

NRPE​

Dans la section [/modules], vérifiez que le serveur NRPE est activé :

NRPEServer = 1

Dans la section [/settings/NRPE/server]:

  • Saisissez l'adresse IP des Collecteurs Centreon autorisĂ©s Ă  superviser le serveur:
allowed hosts = @IP_Poller1, @IP_Poller2
  • VĂ©rifiez que le numĂ©ro de port NRPE utilisĂ© est dĂ©fini sur 5666 :
port = 5666
  • Centreon recommande l'utilisation du chiffrement SSL/TLS des donnĂ©es Ă©changĂ©es. Ainsi, VĂ©rifiez que l'option correspondante est activĂ©e :
use ssl = true
  • VĂ©rifiez que la taille maximale des paquets est bien dĂ©finie Ă  8192 :
payload length = 8192
  • Enfin, depuis une interface ligne de commandes (cmd/powershell), redĂ©marrez l'agent NSCP :
net stop nscp
net start nscp

(Il est également possible de redémarrer le service via la console de management des Services Windows).

Serveur Web / RestAPI​

NSClient++ embarque nativement un serveur Web permettant la supervision via le protocole HTTPS, privilégié par rapport aux anciens protocoles NRPE et NSCLIENT, et ce pour les raisons suivantes :

  • Protocole sĂ©curisĂ© par dĂ©faut
  • Utilisation possible de certificats personnalisĂ©s
  • Suppression des problèmes de compatibilitĂ© NRPE v2/v3

Prérequis​

  • Le port HTTPS 8443/TCP doit ĂŞtre ouvert et accessible sur le serveur Windows cible afin de permettre la communication du collecteur Centreon avec l'API NSClient++
  • Comme pour le protocole NRPE, les paramètres port et allowed hosts de la section /settings/WEB/server doivent ĂŞtre renseignĂ©s dans le fichier nsclient.ini (le numĂ©ro de port Ă  utiliser est ici le 8443 ou tout autre port personnalisĂ© >1024).

Configurer l'accès Rest HTTPS​

Pour utiliser l’API Rest de NSClient++, vous devez tout d'abord activer le service web :

  • En tant qu'administrateur, depuis un shell sous le serveur Windows, exĂ©cutez les commandes suivantes :
nscp web install
  • Configurez un mot de passe afin de sĂ©curiser la communication.
nscp web -- password --set new-password
Password updated successfully, please restart nsclient++ for changes to affect.

Il est également possible d'afficher le mot de passe précédemment défini :

nscp web -- password --display
Current password: centreon
  • Enfin, redĂ©marrez l'agent NSCP
net stop nscp
net start nscp
  • En local sur le serveur Windows, vĂ©rifiez que le serveur Web est opĂ©rationnel Ă  l'adresse https://127.0.0.1:8443/

image

Diagnostic des erreurs communes​

En cas de soucis de configuration et/ou d'exploitation, référez-vous à la documentation officielle de NSClient++ qui offre les résolutions aux problèmes les plus courants.

Vous pouvez aussi nous rendre visite et ouvrir une issue sur la page Github du projet centreon-nsclient pour toute problématique liée aux Plugins Centreon.