From 32707ed9433cedf379ceb2b9ad54dd8556032004 Mon Sep 17 00:00:00 2001 From: Gz Date: Sun, 23 May 2021 16:32:55 +0000 Subject: [PATCH] docs: update Supervision/Centreon/Plugins --- Supervision/Centreon/Plugins.html | 86 +++++++++++++++++++++++++++++-- 1 file changed, 81 insertions(+), 5 deletions(-) diff --git a/Supervision/Centreon/Plugins.html b/Supervision/Centreon/Plugins.html index da03a53..f5520f7 100644 --- a/Supervision/Centreon/Plugins.html +++ b/Supervision/Centreon/Plugins.html @@ -2,7 +2,7 @@ title: Les plugins description: Les commandes à l'aide de plugins published: true -date: 2021-05-23T16:27:50.051Z +date: 2021-05-23T16:32:53.373Z tags: editor: ckeditor dateCreated: 2021-05-23T16:18:38.911Z @@ -91,10 +91,86 @@ drwxr-xr-x 23 centreon centreon  305 16 juil. 12:47 storage 
$USER1$/check_centreon_snmp_memory -H $HOSTADDRESS$ -C $ARG1$ -v $ARG2$ -w $ARG3$ -c $ARG4$

L’exécutable « centreon_plugins.pl » s’utilise de la même façon cependant il se trouve dans /usr/lib/nagios/plugins/centreon-plugins/
Afin d’utiliser ce plugin nous allons donc créer une nouvelle ressource.
Pour cela aller dans Configuration puis « pollers » puis « ressources » et cliquer sur « add »

-

 

-

 

-

 

-

 

+

Remplir les informations comme sur la capture d’écran et cliquer sur « save »

+
+

Les commandes qui seront enregistrées dans Centreon commenceront donc par $USER3$/centreon_plugins.pl
Maintenant que tout est prêt, nous allons faire AVANT TOUT un test directement depuis la CLI de centreon.
Commencer par faire une recherche des différents plugins Windows à disposition.

+
cd /usr/lib/nagios/plugins/centreon-plugins
+./centreon_plugins.pl --list-plugin | grep os | grep windows
+PLUGIN: os::windows::snmp::plugin
+PLUGIN: os::windows::wsman::plugin
+PLUGIN: os::windows::local::plugin
+
+

Il est également possible d’effectuer des recherches dans chacun des différents répertoires précédemment cités : apps, centreon, cloud, contrib, database, docs, Example, hardware, Network, notification, Os, snmp_standard, storage

+

La marche à suivre sera la même :

+
./centreon_plugins.pl --list-plugin | grep database
+PLUGIN: database::informix::plugin
+PLUGIN: database::oracle::plugin
+PLUGIN: database::mysql::plugin
+PLUGIN: database::mssql::plugin
+PLUGIN: database::firebird::plugin
+            --database
+PLUGIN: database::sap::hana::plugin
+    --database
+PLUGIN: database::postgres::plugin
+            --database
+PLUGIN: database::sybase::plugin
+

Pour revenir à Windows, le plugin qui nous intéresse et qui permettra de faire des checks en snmp est le PLUGIN: os::windows::snmp::plugin
Il s’agit en réalité d’une arborescence qui pourrait être vue de cette manière : os/windows/snmp/plugin/
Chaque plugin comprend différents modes d’exécution qui peuvent être utilisés. Ces modes peuvent être vu comme des catégories.
Pour afficher la liste des modes de Windows, effectuer la commande suivante

+
./centreon_plugins.pl --plugin=os::windows::snmp::plugin --list-mode
+
+Plugin Description:
+    Check Windows operating systems in SNMP.
+
+Global Options:
+    --mode  Choose a mode.
+
+    --dyn-mode
+            Specify a mode with the path (separated by '::').
+
+    --list-mode
+            List available modes.
+
+    --mode-version
+            Check minimal version of mode. If not, unknown error.
+
+    --version
+            Display plugin version.
+
+Modes Available:
+   cpu
+   interfaces
+   list-interfaces
+   list-storages
+   memory
+   processcount
+   service
+   storage
+   swap
+   time
+   uptime
+

La liste affichée en vert (ça ne sera pas le cas sur centreon) correspond aux modes disponibles pour superviser un hôte Windows.
A titre d’exemple pour cette procédure, le mode CPU sera utilisé.
Commencer par afficher l’aide pour voir les arguments à utiliser 

+
./centreon_plugins.pl --plugin=os::windows::snmp::plugin --mode=cpu --help
+

Une liste détaillée comprenant 4 grandes parties va apparaitre (le détail ne sera pas repris ici) :

+ +

Maintenant qu’on a vu les différentes options, passons à l’exécution de la commande

+
./centreon_plugins.pl --plugin=os::windows::snmp::plugin --mode=cpu --hostname=10.0.0.8 --snmp-community=public --snmp-version=2c
+OK: 2 CPU(s) average usage is: 40.00% | 'cpu0'=40.00%;;;0;100 'cpu1'=40.00%;;;0;100 'total_cpu_avg'=40.00%;;;0;100
+

 

+

--plugin=os::windows::snmp::plugin                -> Le chemin du plugin utilisé dans la commande
--mode=cpu                                                         -> le mode utilisé par le plugin
--hostname=10.0.0.8                                         -> le nom FQDM ou l’ip du serveur à sonder (peut varier selon le mode choisi)
--snmp-community=public                                -> la communauté SNMP configurée sur le serveur (peut varier selon le mode choisi)
--snmp-version=2c                                              -> la version du protocole SNMP qui sera utilisé

+

Il est possible d’ajouter des avertissements à la commande afin de définir un niveau d’alerte à l’aide de --warning=X et --critical=Y ( X et Y sont des pourcentages)

+
./centreon_plugins.pl --plugin=os::windows::snmp::plugin --mode=cpu --hostname=10.0.0.8 --snmp-community=public --snmp-version=2c --warning=75 --critical=90
+OK: 2 CPU(s) average usage is: 42.00% | 'cpu0'=41.00%;;;0;100 'cpu1'=43.00%;;;0;100 'total_cpu_avg'=42.00%;0:75;0:90;0;100
+

Les tests fait directement depuis la CLI de centreon étant concluant, passons à la création de commandes depuis l’interface graphique.
Si l’on souhaite vérifier l’utilisation des CPU il est tout à fait possible de reprendre la commande précédemment utilisée, ce qui donnera : 

+
$USER3$/centreon_plugins.pl --plugin=os::windows::snmp::plugin --mode=cpu --hostname=$HOSTADDRESS$ --snmp-community=$ARG1$ --snmp-version=$ARG2$ --warning=$ARG3$ --critical=$ARG4$
+

Les variables seront à définir dans le Template de service :

+

$HOSTADDRESS$                 -> IP
$ARG1$                                 -> la communauté SNMP
$ARG2$                                 -> la version du protocole SNMP qui sera utilisée
$ARG3$                                 -> valeur à définir pour une alerte de type « warning »
$ARG4$                                 -> valeur à définir pour une alerte de type « critique »

+

Cependant toujours à des fins d’exemple pour cette procédure, nous allons effectuer une commande utilisant des « macros personnalisées » afin de vérifier le trafic des interfaces réseau de nos serveurs.

+

Les macros standards sont prédéfinies dans le code source des moteurs de supervision. Ces différentes macros permettent de récupérer la valeur de différents objets au sein des commandes. Une macro commence et se termine toujours par le signe « $ ».
Une liste complète des macros est disponible à cette adresse

+

Commencer par se connecter à l’interface graphique de Centreon puis cliquer sur « pollers », « ressources » puis « add »