Procedure-Systel/Centreon/Configuration du fichier NSClient++ pour le modèle OS-Windows-NRPE-2-Disks.md

Configurer NSClient++ pour le modèle OS-Windows-NRPE-2-Disks

1. Objectif

Cette procédure décrit la configuration de l'agent NSClient++ sur un serveur Windows afin de permettre sa supervision par Centreon au moyen du protocole NRPE.

2. Emplacement du fichier de configuration

Le fichier de configuration NSClient++ se trouve sur le serveur Windows à superviser :

• C:\Program Files\NSClient++\nsclient.ini

Il est recommandé d'ouvrir ce fichier avec Notepad++ pour faciliter la modification et l'enregistrement des paramètres.

3. Configuration de base

Les paramètres suivants doivent être présents dans le fichier nsclient.ini.

Section [/modules]

[/modules]
CheckSystem = 1
CheckDisk = 1
CheckExternalScripts = 1
NRPEServer = 1

Section [/settings/default]

[/settings/default]
; Adresse IP du collecteur/poller Centreon
allowed hosts = 127.0.0.1,<IP_DU_POLLER>
timeout = 60

Section [/settings/NRPE/server]

[/settings/NRPE/server]
allow arguments = true
allow nasty characters = true
port = 5666
use ssl = false
insecure = true
timeout = 60

4. Description des paramètres

4.1 Section [/module]

Cette section permet d'activer (1) ou de désactiver (0) les différents modules de l'agent NSClient++.

CheckSystem = 1

Active le module de supervision système. Il permet à Centreon de contrôler :

• L'utilisation du processeur (CPU).
• La consommation de la mémoire vive (RAM).
• L'état des services Windows.

CheckDisk = 1

Active le module de supervision du stockage. Il est indispensable pour surveiller :

• L'espace disque disponible.
• L'utilisation des volumes.

CheckExternalScripts = 1

Autorise l'exécution de scripts externes présents sur le serveur Windows, tels que :

• Scripts PowerShell.
• Scripts Batch (.bat).
• Scripts personnalisés.

NRPEServer = 1

Active le serveur NRPE intégré à NSClient++. Ce service permet au poller Centreon d'interroger le serveur Windows au moyen du protocole NRPE (Nagios Remote Plugin Executor).

4.2 Section [/settings/default]

Cette section définit les paramètres généraux de communication.

allowed hosts

Exemple :

allowed hosts = 127.0.0.1, 192.168.1.10

Dans cet exemple, seul le poller Centreon dont l'adresse IP est 192.168.1.10 pourra envoyer des requêtes NRPE.

Délai d'attente par défaut (timeout = 60)

Définit le délai maximal d'attente d'une requête avant expiration.

4.3 Section [/settings/NRPE/server]

Cette section configure le fonctionnement du serveur NRPE.

allow arguments = true

Autorise le poller Centreon à transmettre des arguments dynamiques aux commandes exécutées sur le serveur. N'activer cette option que si elle est nécessaire et limiter l'accès au service NRPE aux pollers autorisés.

Exemple :

• Seuil d'alerte CPU à 80 %.
• Seuil d'espace disque libre à 10 %.

allow nasty characters = true

Autorise l'utilisation de caractères spéciaux dans les arguments transmis par Centreon.

Exemples :

• -
• $
• |
• &

Ce paramètre est souvent nécessaire pour certains scripts ou commandes avancées.

port = 5666

Définit le port TCP utilisé par le service NRPE pour écouter les connexions entrantes. Le port standard NRPE est :

• 5666/TCP

use ssl = false

Désactive le chiffrement SSL des échanges entre Centreon et NSClient++. Les données transitent donc en clair sur le réseau ; réserver cette configuration à un réseau de confiance.

insecure = true

Désactive certaines vérifications de sécurité liées aux certificats et aux protocoles de chiffrement. Cette option ne chiffre pas les échanges et ne remplace pas une configuration réseau sécurisée.

Délai d'attente NRPE (timeout = 60)

Détermine le délai maximum accordé à l'exécution d'une requête NRPE avant expiration.

5. Redémarrage du service

Après avoir enregistré les modifications dans nsclient.ini, redémarrer le service NSClient++ pour appliquer la nouvelle configuration. Cette opération peut être effectuée :

• Depuis la console des services Windows (services.msc).
• Depuis une invite de commandes ouverte en tant qu'administrateur.

net stop nscp
net start nscp

6. Configuration Centreon

Après la configuration de l'agent NSClient++, il est nécessaire de modifier les paramètres de l'hôte supervisé dans Centreon.

Macro personnalisée

Dans les macros personnalisées de l'hôte, renseigner la valeur suivante :

Macro : NRPEEXTRATIONS
Valeur : -n -2 -t 30

Description des options

• -n : désactive le chiffrement SSL côté Centreon.
• -2 : force l'utilisation du protocole NRPE version 2.
• -t 30 : définit un délai d'attente de 30 secondes pour les contrôles NRPE.

7. Validation

Une fois la configuration terminée :

• Vérifier que le port 5666/TCP est accessible depuis le poller Centreon.
• Redémarrer le service NSClient++.
• Effectuer un test de supervision depuis Centreon.
• Vérifier que les services remontent correctement et que leur état est conforme.

Conclusion

La communication entre Centreon et NSClient++ est désormais configurée pour le modèle de supervision OS-Windows-NRPE-2-Disks.