<h1>Mise en place de commandes (checks) à l’aide de plugins</h1>
<p>En plus des différents checks disponibles par défaut dans Centreon, il existe des plugins, gratuit ou payant, que l’on peut télécharger.<br>Centreon étant un outil de supervision open source et communautaire, il est également possible de trouver des plugins gratuits mis à disposition par la communauté.<br>Une autre solution est de créer directement ses propres plugins, à condition d’avoir les connaissances nécessaires.</p>
<h2>Configuration des checks a partir des Packs de Plugins inclus dans Centreon</h2>
<h3>Ajout de Plugins</h3>
<p>Centreon est un excellent outil de supervision qui peut être configuré manuellement pour correspondre exactement aux différents besoins de l’entreprise. Toutefois, il existe des packs de plugins contenant des modèles de configuration.<br>Ces différents packs réduisent le temps nécessaire pour installer et superviser la plupart des services de l’entreprise.<br>Pour fonctionner, les composants techniques Centreon License Manager et Centreon Plugin Pack Manager sont nécessaires.*</p>
<p>L’installation de ces deux paquets est très simple.<br>En fonction de la version de Centreon utilisée, il sera nécessaire soit d’installer en ligne de commande ces deux packages soit directement de les installer depuis l’interface graphique.</p>
<p>Pour commencer se rendre dans la section « Administration » puis « Extensions » et enfin « Modules ».<br>Vérifier si les deux modules sont présents. </p>
<p>S’ils n’y sont pas, il faudra installer les packages en ligne de commande avant de poursuivre.<br>Pour effectuer l’installation des packages en ligne de commande, se connecter sur le serveur Centreon avec l’utilisateur root en SSH et de taper la commande suivante.</p>
<p>Cette commande téléchargera Centreon Plugin Pack Manager et également Centreon License Manager en tant que dépendance.<br>Une fois ces deux paquets téléchargés et présent dans « Modules », il suffira de les installer.<br>Le premier module à installer et activer sera Centreon License Manager : cliquer sur le nom du module puis sur « install moduel »</p>
<p>Lorsque les deux modules seront installés, il sera désormais possible de se rendre dans la section « Configuration » puis « Plugin packs » pour trouver les 6 plugins gratuits proposés. Si on s’inscrit sur le site de Centreon, 5 autres plugins packs deviennent gratuits, les autres étant payant.</p>
<p>Il existe plus de 150 plugins packs disponibles dans l’offre IMP.</p>
<p>Comme indiqué précédemment, suite à l’installation des deux modules, des packs de plugins sont maintenant disponible.<br>Pour activer les plugins, se rendre dans « Configuration » puis « Plugin packs », puis cliquer sur le plugin à installer.<br>Dans le cadre de cette procédure, le plugin de check SNMP de Linux sera installé </p>
<p>Pour l’installer il suffit de cliquer sur l’icone <spanclass="text-huge"><strong>+</strong></span><br>Patienter pour que le plugin s’installe automatiquement.<br>Une fois installé l’icône du plugin affiche une marque, confirmant l’installation </p>
<p>Les différents checks et Templates seront à présent disponibles dans leurs sections respectives.</p>
<h3>Utilisation des checks fournis par les modules</h3>
<p>Pour utiliser les différents checks inclus dans les packs de modules il faut absolument garder en tête la notion d’héritage qui a été précédemment expliqué.<br>En effet, les commandes, Templates de services et Templates d’Hôtes sont déjà liés les uns aux autres lors de l’installation d’un pack.</p>
<p>Généralement, lors de l’installation d’un pack, cette notion de hiérarchie et d’héritage ne sera pas retouchée mais plutôt utilisée.<br>Il sera toutefois nécessaire de customiser les valeurs des « warning », « critical » et autres valeurs à vérifier.<br>Pour les besoins de cette procédure voici un exemple.<br>Lors de l’’installation des packs « Linux SNMP » ou « Windows SNMP », le Template de service « Base-Ping-LAN » devient accessible.</p>
<p>Ce Template va permettre d’effectuer la supervision de la connectivité réseau à l’aide du ping pour les hôtes liés à ce Template. Toutefois il est nécessaire de le configurer selon ses besoins, le nombre de paquets envoyés ou les valeurs pour le « warning » et « critical » ne sont pas forcément celles que l’on souhaite. Il est également important de positionner correctement l’ensemble des périodes de check, des intervalles de supervision ainsi que les notifications comme indiqué précédemment dans cette procédure.</p>
<h3>Personnalisation des Checks à partir de ceux des plugins</h3>
<p>Une fois les plugins installés, un certain nombre de commandes et de Templates sont disponibles.<br>Nous avons vu comment les utiliser mais il est également possible si on le souhaite de ne pas utiliser les Templates prédéfinies et de recréer ses propres Templates à partir des commandes (checks) disponibles.<br>Pour cela il faudra procéder de la même façon que précédemment dans cette procédure.</p>
<h2>Configuration des checks à partir des packs de plugins fournis par la communauté</h2>
<p>Il existe de nombreux sites proposant des listes de plugins mis à disposition gratuitement.<br>Par exemple, le site « exchange Nagios » est plutôt bien fourni : <ahref="https://exchange.nagios.org">https://exchange.nagios.org</a><br>Toute fois pour les besoins de cette procédure, nous allons prendre en exemple le plugin « centreon_plugins.pl ».<br>Il s’agit d’un plugin écrit en perl qui est très complet et qui permet de mettre en place un très grand nombre de checks différents.</p>
<h3>Installation de « centreon_plugins.pl »</h3>
<p>Avant toute chose, si ce n’est pas déjà fait il faut installer la commande « git » </p>
<p>Une fois la commande installée, se déplacer dans le répertoire /tmp puis télécharger le plugin depuis <ahref="https://github.com/centreon/centreon-plugins">Github</a> à l’aide des commandes ci-dessous :</p>
<li>Les parties en bleues sont des dossiers contenant les informations que le plugin va utiliser lors des différents checks.</li>
<li>Les parties en vert sont des exécutables. Celui qui nous intéresse et que nous utiliserons est « centreon_plugins.pl ».</li>
</ul>
<p>Précédemment nous avons vu que lorsque nous utilisions une commande, la variable « <i>$USER1$</i> » était utilisée.<br>Elle correspond au chemin suivant : <i>/usr/lib/nagios/plugins/</i> et permet de faire appel aux commandes se trouvant dans ce répertoire.<br>Par exemple : <i>/usr/lib/nagios/plugins/check_centreon_snmp_memory</i> en y associant les valeurs nécessaires au check permettra d’effectuer un check de la RAM sur le ou les appareils ciblés.</p>
<p>L’exécutable « centreon_plugins.pl » s’utilise de la même façon cependant il se trouve dans <i>/usr/lib/nagios/plugins/centreon-plugins/</i><br>Afin d’utiliser ce plugin nous allons donc créer une nouvelle ressource.<br>Pour cela aller dans Configuration puis « pollers » puis « ressources » et cliquer sur « add »</p>
<p>Les commandes qui seront enregistrées dans Centreon commenceront donc par <i>$USER3$/centreon_plugins.pl</i><br>Maintenant que tout est prêt, nous allons faire <u>AVANT TOUT</u> un test directement depuis la CLI de centreon.<br>Commencer par faire une recherche des différents plugins Windows à disposition.</p>
./centreon_plugins.pl --list-plugin | grep os | grep windows
PLUGIN: os::windows::snmp::plugin
PLUGIN: os::windows::wsman::plugin
PLUGIN: os::windows::local::plugin
</code></pre>
<p>Il est également possible d’effectuer des recherches dans chacun des différents répertoires précédemment cités : <i>apps, centreon, cloud, contrib, database, docs, Example, hardware, Network, notification, Os, snmp_standard, storage</i></p>
<p>Pour revenir à Windows, le plugin qui nous intéresse et qui permettra de faire des checks en snmp est le PLUGIN: <i>os::windows::snmp::plugin</i><br>Il s’agit en réalité d’une arborescence qui pourrait être vue de cette manière : <i>os/windows/snmp/plugin/</i><br>Chaque plugin comprend différents modes d’exécution qui peuvent être utilisés. Ces modes peuvent être vu comme des catégories.<br>Pour afficher la liste des modes de Windows, effectuer la commande suivante</p>
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</code></pre>
<p>La liste affichée en vert (ça ne sera pas le cas sur centreon) correspond aux modes disponibles pour superviser un hôte Windows.<br>A titre d’exemple pour cette procédure, le mode CPU sera utilisé.<br>Commencer par afficher l’aide pour voir les arguments à utiliser </p>
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</code></pre>
<p> </p>
<p><i>--plugin=os::windows::snmp::plugin -> Le chemin du plugin utilisé dans la commande</i><br><i>--mode=cpu -> le mode utilisé par le plugin</i><br><i>--hostname=10.0.0.8 -> le nom FQDM ou l’ip du serveur à sonder (peut varier selon le mode choisi)</i><br><i>--snmp-community=public -> la communauté SNMP configurée sur le serveur (peut varier selon le mode choisi)</i><br><i>--snmp-version=2c -> la version du protocole SNMP qui sera utilisé</i></p>
<p>Il est possible d’ajouter des avertissements à la commande afin de définir un niveau d’alerte à l’aide de --<i>warning=X</i> et --<i>critical=Y</i> ( X et Y sont des pourcentages)</p>
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</code></pre>
<p>Les tests fait directement depuis la CLI de centreon étant concluant, passons à la création de commandes depuis l’interface graphique.<br>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 : </p>
<p>Les variables seront à définir dans le Template de service :</p>
<p><i>$HOSTADDRESS$ -> IP</i><br><i>$ARG1$ -> la communauté SNMP</i><br><i>$ARG2$ -> la version du protocole SNMP qui sera utilisée</i><br><i>$ARG3$ -> valeur à définir pour une alerte de type « warning »</i><br><i>$ARG4$ -> valeur à définir pour une alerte de type « critique »</i></p>
<p>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.</p>
<p>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 « <strong>$</strong> ».<br>Une liste complète des macros est disponible à <ahref="https://assets.nagios.com/downloads/nagioscore/docs/nagioscore/3/en/macrolist.html"><strong>cette adresse</strong></a></p>
<p>Commencer par se connecter à l’interface graphique de Centreon puis cliquer sur « pollers », « ressources » puis « add » </p>
<p>Une fois les macros créées et sauvegardées, cliquer sur « configuration » puis sur « commands » puis sur « check » et enfin sur « add »</p>
<p>Cliquer sur le bouton « Describe macros » <br>Un pop-up va alors s’ouvrir permettant de décrire les différentes macros qui seront utilisées<br>Attention, les informations utilisées ici le sont à titre d’exemple afin d’avoir une bonne visibilité de la commande. Les valeurs qui seront réellement utilisées seront définies dans le Template de service qui sera créée par la suite.</p>
<p>Valider la création de la commande en cliquant sur « save »</p>
<p>Les serveurs ayant plusieurs interfaces, il nous faut dans un premier temps savoir quelle est l’ID de l’interface que l’on souhaite superviser. Pour cela effectuer la commande suivante directement dans la CLI de centreon : </p>
'Software Loopback Interface 1' [speed = 1073, status = up, id = 1]
Skipping interface 'WAN Miniport (IKEv2)': no matching filter status
'Broadcom BCM5708C NetXtreme II GigE (NDIS VBD Client) #46' [speed = 1000, status = up, id = 7]</code></pre>
<p>Dans notre exemple l’ID de l’interface est «7 ». C’est cette valeur qui sera utilisée afin de récolter des informations lors de l’utilisation du check</p>
<p>Passons maintenant à la création du Template de service qui utilisera cette commande.</p>
<p>Cliquer sur « Configuration » puis « Services » puis sur « Templates » et en fin sur « add »<br>De la même manière que vu précédemment lors de la création de Templates, nous allons remplir les informations mais cette fois-ci ce seront les « macros personnalisées » qui seront utilisées et définies</p>
<p>Cliquer sur « save » pour enregistrer la Template<br>Cliquer sur « Configuration » puis « Hosts » puis sur « Templates » et en fin sur « add »<br>A nouveau, de la même manière que vu précédemment lors de la création de Templates, nous allons créer un Template d’hôte dédiée à la vérification du trafic.<br>Remplir les différentes informations puis dans la section « relations » choisir le Template de service précédemment créée pour l’associer avec ce Template d’host.</p>
<p>Cliquer sur « save » pour enregistrer le Template<br>Il ne reste plus qu’à associer ce Template avec un hôte.</p>
