Maxime BOURIEAU
186 lines
5.2 KiB
Markdown
186 lines
5.2 KiB
Markdown
# 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]`**
|
|
|
|
```ini
|
|
[/modules]
|
|
CheckSystem = 1
|
|
CheckDisk = 1
|
|
CheckExternalScripts = 1
|
|
NRPEServer = 1
|
|
```
|
|
|
|
**Section `[/settings/default]`**
|
|
|
|
```ini
|
|
[/settings/default]
|
|
; Adresse IP du collecteur/poller Centreon
|
|
allowed hosts = 127.0.0.1,<IP_DU_POLLER>
|
|
timeout = 60
|
|
```
|
|
|
|
**Section `[/settings/NRPE/server]`**
|
|
|
|
```ini
|
|
[/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.
|
|
|
|
```bat
|
|
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 :
|
|
|
|
```text
|
|
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.
|