Wiki-Tech.io/Supervision/Centreon/Plugins.html

226 lignes
25 KiB
HTML

<!--
title: Les plugins
description: Les commandes à l'aide de plugins
published: true
date: 2021-09-24T21:08:01.605Z
tags:
editor: ckeditor
dateCreated: 2021-05-24T10:37:15.994Z
-->
<figure class="image image_resized" style="width:44.15%;"><img src="https://static.centreon.com/wp-content/uploads/2019/10/Centreon_Logo_RVB_HD_Cut.png?x55598" alt="Centreon | Supervision Informatique : Infrastuctures Hybrides, Cloud, AIOps">
<figcaption><strong>Auteur : Antoine JOVELIN</strong><br><strong>Admin Système Réseau - 49100 Angers</strong></figcaption>
</figure>
<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 «&nbsp;Administration&nbsp;» puis «&nbsp;Extensions&nbsp;» et enfin «&nbsp;Modules&nbsp;».<br>Vérifier si les deux modules sont présents.&nbsp;</p>
<figure class="image"><img src="/images/plugins_centreon-5.png"></figure>
<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>
<pre><code class="language-plaintext">yum install centreon-pp-manager</code></pre>
<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 «&nbsp;Modules&nbsp;», il suffira de les installer.<br>Le premier module à installer et activer sera Centreon License Manager&nbsp;: cliquer sur le nom du module puis sur «&nbsp;install moduel&nbsp;»</p>
<figure class="image"><img src="/images/plugins_centreon-6.png"></figure>
<p>Puis il faudra installer et activer Centreon Plugin Pack Manager&nbsp;: cliquer sur le nom du module puis sur «&nbsp;install moduel&nbsp;»</p>
<figure class="image"><img src="/images/plugins_centreon-7.png"></figure>
<p>Lorsque les deux modules seront installés, il sera désormais possible de se rendre dans la section «&nbsp;Configuration&nbsp;» puis «&nbsp;Plugin packs&nbsp;» 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>
<figure class="image"><img src="/images/plugins_centreon-8.png"></figure>
<h3>Activation des modules selon les besoins</h3>
<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 «&nbsp;Configuration&nbsp;» puis «&nbsp;Plugin packs&nbsp;», puis cliquer sur le plugin à installer.<br>Dans le cadre de cette procédure, le plugin de check SNMP de Linux sera installé&nbsp;</p>
<figure class="image"><img src="/images/plugins_centreon-9.png"></figure>
<p>Cliquer sur le plugin pour afficher les détails&nbsp;</p>
<figure class="image"><img src="/images/plugins_centreon-10.png"></figure>
<p>Pour l’installer il suffit de cliquer sur l’icone <span class="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&nbsp;</p>
<figure class="image"><img src="/images/plugins_centreon-11.png"></figure>
<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><u>Petit rappel&nbsp;:&nbsp;</u></p>
<figure class="image"><img src="/images/checks_centreon.png"></figure>
<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 «&nbsp;warning&nbsp;», «&nbsp;critical&nbsp;» et autres valeurs à vérifier.<br>Pour les besoins de cette procédure voici un exemple.<br>Lors de l’’installation des packs «&nbsp;Linux SNMP&nbsp;» ou «&nbsp;Windows SNMP&nbsp;», le Template de service «&nbsp;Base-Ping-LAN&nbsp;» devient accessible.</p>
<figure class="image"><img src="/images/plugins_centreon-12.png"></figure>
<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 «&nbsp;warning&nbsp;» et «&nbsp;critical&nbsp;» 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>
<p>En effet par défaut, tout est vide.</p>
<figure class="image"><img src="/images/plugins_centreon-13.png"></figure>
<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 «&nbsp;exchange Nagios&nbsp;» est plutôt bien fourni&nbsp;: <a href="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 «&nbsp;centreon_plugins.pl&nbsp;».<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 «&nbsp;centreon_plugins.pl&nbsp;»</h3>
<p>Avant toute chose, si ce n’est pas déjà fait il faut installer la commande «&nbsp;git&nbsp;»&nbsp;</p>
<pre><code class="language-plaintext">yum install git</code></pre>
<p>Une fois la commande installée, se déplacer dans le répertoire /tmp puis télécharger le plugin depuis <a href="https://github.com/centreon/centreon-plugins">Github</a>&nbsp;à l’aide des commandes ci-dessous :</p>
<pre><code class="language-plaintext">cd /tmp
git clone https://github.com/centreon/centreon-plugins</code></pre>
<p>Le répertoire «&nbsp;centreon-plugins&nbsp;» devrait être visible dans /tmp</p>
<pre><code class="language-plaintext">ll
drwxr-xr-x 17 root root 309 27 août&nbsp; 16:24 centreon-plugins</code></pre>
<p>Déplacer le dossier dans /usr/lib/nagios/plugins/ puis lui ajouter les droits nécessaires pour son exécution par centreon&nbsp;</p>
<pre><code class="language-plaintext">cp centreon-plugins /usr/lib/nagios/plugins/
cd /usr/lib/nagios/plugins
chmod 755 -Rf centreon-plugins
chown -Rf centreon:centreon centreon-plugins</code></pre>
<h3>Utilisation du plugin «&nbsp;centreon_plugins.pl&nbsp;»</h3>
<p>Avant de commencer, voici le contenu du dossier&nbsp;:</p>
<pre><code class="language-plaintext">drwxr-xr-x 47 centreon centreon&nbsp; 4096 16 juil. 12:47 apps
drwxrwxr-x&nbsp; 4 centreon centreon&nbsp; 35 16 juil. 12:47 centreon
-rwxr-xr-x&nbsp; 1 centreon centreon&nbsp; 989 16 juil. 12:34 centreon_plugins.pl
-rwxr-xr-x&nbsp; 1 centreon centreon 15135 16 juil. 12:34 changelog
drwxr-xr-x&nbsp; 7 centreon centreon&nbsp; 77 16 juil. 12:47 cloud
drwxr-xr-x&nbsp; 2 centreon centreon&nbsp; 46 16 juil. 12:47 contrib
drwxr-xr-x 10 centreon centreon&nbsp; 119 16 juil. 12:47 database
drwxr-xr-x&nbsp; 4 centreon centreon&nbsp; 26 16 juil. 12:47 docs
drwxr-xr-x&nbsp; 4 centreon centreon&nbsp; 107 16 juil. 12:47 example
drwxr-xr-x 10 centreon centreon&nbsp; 110 16 juil. 12:47 hardware
-rwxrwxr-x&nbsp; 1 centreon centreon&nbsp; 2752 20 août&nbsp; 10:24 host-email.php
-rwxr-xr-x&nbsp; 1 centreon centreon 11357 16 juil. 12:34 LICENSE.txt
drwxr-xr-x 63 centreon centreon&nbsp; 4096 16 juil. 12:47 network
drwxr-xr-x&nbsp; 5 centreon centreon&nbsp; 48 16 juil. 12:47 notification
drwxr-xr-x&nbsp; 8 centreon centreon&nbsp; 87 16 juil. 12:47 os
-rwxr-xr-x&nbsp; 1 centreon centreon&nbsp; 3194 16 juil. 12:34 README.md
-rwxrwxr-x&nbsp; 1 centreon centreon&nbsp; 5180 20 août&nbsp; 10:24 service-email.php
drwxr-xr-x&nbsp; 3 centreon centreon&nbsp; 18 16 juil. 12:47 snmp_standard
drwxr-xr-x 23 centreon centreon&nbsp; 305 16 juil. 12:47 storage</code></pre>
<p><u>A savoir&nbsp;:</u></p>
<ul>
<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 «&nbsp;centreon_plugins.pl&nbsp;».</li>
</ul>
<p>Précédemment nous avons vu que lorsque nous utilisions une commande, la variable «&nbsp;<i>$USER1$</i>&nbsp;» était utilisée.<br>Elle correspond au chemin suivant&nbsp;: <i>/usr/lib/nagios/plugins/</i> et permet de faire appel aux commandes se trouvant dans ce répertoire.<br>Par exemple&nbsp;: <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>
<pre><code class="language-plaintext">$USER1$/check_centreon_snmp_memory -H $HOSTADDRESS$ -C $ARG1$ -v $ARG2$ -w $ARG3$ -c $ARG4$</code></pre>
<p>L’exécutable «&nbsp;centreon_plugins.pl&nbsp;» 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 «&nbsp;pollers&nbsp;» puis «&nbsp;ressources&nbsp;» et cliquer sur «&nbsp;add&nbsp;»</p>
<figure class="image"><img src="/images/plugins_centreon-14.png"></figure>
<p>Remplir les informations comme sur la capture d’écran et cliquer sur «&nbsp;save&nbsp;»</p>
<figure class="image"><img src="/images/plugins_centreon-15.png"></figure>
<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>
<pre><code class="language-plaintext">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
</code></pre>
<p>Il est également possible d’effectuer des recherches dans chacun des différents répertoires précédemment cités&nbsp;: <i>apps, centreon, cloud, contrib, database, docs, Example, hardware, Network, notification, Os, snmp_standard, storage</i></p>
<p>La marche à suivre sera la même&nbsp;:</p>
<pre><code class="language-plaintext">./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</code></pre>
<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&nbsp;: <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>
<pre><code class="language-plaintext">./centreon_plugins.pl --plugin=os::windows::snmp::plugin --list-mode
Plugin Description:
Check Windows operating systems in SNMP.
Global Options:
--mode&nbsp; 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</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&nbsp;</p>
<pre><code class="language-plaintext">./centreon_plugins.pl --plugin=os::windows::snmp::plugin --mode=cpu --help</code></pre>
<p>Une liste détaillée comprenant 4 grandes parties va apparaitre&nbsp;(le détail ne sera pas repris ici) :</p>
<ul>
<li><i>Global Options</i> : les options globales</li>
<li><i>Output Options</i> : les options de sortie</li>
<li><i>Snmp Options</i> : Les options SNMP (Communauté, version….)</li>
<li><i>Mode</i> : les arguments que l’on peut rajouter lors de la vérification</li>
</ul>
<p>Maintenant qu’on a vu les différentes options, passons à l’exécution de la commande</p>
<pre><code class="language-plaintext">./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</code></pre>
<p>&nbsp;</p>
<p><i>--plugin=os::windows::snmp::plugin &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; Le chemin du plugin utilisé dans la commande</i><br><i>--mode=cpu&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; le mode utilisé par le plugin</i><br><i>--hostname=10.0.0.8&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; le nom FQDM ou l’ip du serveur à sonder (peut varier selon le mode choisi)</i><br><i>--snmp-community=public&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; la communauté SNMP configurée sur le serveur (peut varier selon le mode choisi)</i><br><i>--snmp-version=2c&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; 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&nbsp;à l’aide de --<i>warning=X</i> et --<i>critical=Y</i> ( X et Y sont des pourcentages)</p>
<pre><code class="language-plaintext">./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</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&nbsp;:&nbsp;</p>
<pre><code class="language-plaintext">$USER3$/centreon_plugins.pl --plugin=os::windows::snmp::plugin --mode=cpu --hostname=$HOSTADDRESS$ --snmp-community=$ARG1$ --snmp-version=$ARG2$&nbsp;--warning=$ARG3$&nbsp;--critical=$ARG4$</code></pre>
<p>Les variables seront à définir dans le Template de service&nbsp;:</p>
<p><i>$HOSTADDRESS$ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; IP</i><br><i>$ARG1$&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; la communauté SNMP</i><br><i>$ARG2$&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; la version du protocole SNMP qui sera utilisée</i><br><i>$ARG3$&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; valeur à définir pour une alerte de type «&nbsp;warning&nbsp;»</i><br><i>$ARG4$&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -&gt; valeur à définir pour une alerte de type «&nbsp;critique&nbsp;»</i></p>
<p>Cependant toujours à des fins d’exemple pour cette procédure, nous allons effectuer une commande utilisant des&nbsp;«&nbsp;macros&nbsp;personnalisées&nbsp;» afin de vérifier le trafic des interfaces réseau de nos serveurs.</p>
<p>Les macros&nbsp;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.&nbsp;Une macro commence et se termine toujours par le signe «&nbsp;<strong>$</strong>&nbsp;».<br>Une liste complète des macros est disponible à <a href="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 «&nbsp;pollers&nbsp;», «&nbsp;ressources&nbsp;» puis «&nbsp;add&nbsp;»&nbsp;</p>
<figure class="image"><img src="/images/macro_centreon-1.png"></figure>
<p>Les macros personnalisées vont dépendre de ce qui sera à superviser mais voici une liste qui peut être utile de créer&nbsp;:</p>
<ul>
<li>$_SERVICEMODE$</li>
<li>$_SERVICEDISK$</li>
<li>$_SERVICEHOST$</li>
<li>$_SERVICEINTERFACE$</li>
<li>$_SERVICEOPTION$</li>
<li>$_SERVICEUSERNAME$</li>
<li>$_SERVICEPASSWORD$</li>
<li>$_SERVICEPORT$</li>
<li>$_SERVICEPROCESS$</li>
<li>$_SERVICESID$</li>
<li>$_SERVICECOMMAND$</li>
<li>$_SERVICESUBCOMMAND$</li>
<li>$_SERVICETIMEOUT$</li>
<li>$_SERVICEWARNING$</li>
<li>$_SERVICEWARNINGIN$</li>
<li>$_SERVICEWARNINGOUT$</li>
<li>$_SERVICECRITICAL$</li>
<li>$_SERVICECRITICALIN$</li>
<li>$_SERVICECRITICALOUT$</li>
</ul>
<figure class="image"><img src="/images/macro_centreon-2.png"></figure>
<p>Une fois les macros créées et sauvegardées, cliquer sur «&nbsp;configuration&nbsp;» puis sur «&nbsp;commands&nbsp;» puis sur «&nbsp;check&nbsp;» et enfin sur «&nbsp;add&nbsp;»</p>
<figure class="image"><img src="/images/macro_centreon-3.png"></figure>
<figure class="image"><img src="/images/macro_centreon-4.png"></figure>
<p>Commencer par nommer la commande&nbsp;</p>
<figure class="image"><img src="/images/macro_centreon-5.png"></figure>
<p>Puis écrire la commande dans la section «&nbsp;command line&nbsp;»</p>
<pre><code class="language-plaintext">$USER3$/centreon_plugins.pl --plugin=$_SERVICEPLUGIN$ --hostname=$HOSTADDRESS$ --snmp-community=$_HOSTSNMPCOMMUNITY$ --snmp-version=$_HOSTSNMPVERSION$ --mode=$_SERVICEMODE$ --interface=$_SERVICEINTERFACE$ --warning-in-traffic=$_SERVICEWARNINGIN$ --warning-out-traffic=$_SERVICEWARNINGOUT$ --critical-in-traffic=$_SERVICECRITICALIN$ --critical-out-traffic=$_SERVICECRITICALOUT$ $_SERVICEOPTION$ $_SERVICEOPTION$</code></pre>
<p>Cliquer sur le bouton «&nbsp;Describe macros&nbsp;» &nbsp;<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>
<figure class="image"><img src="/images/macro_centreon-6.png"></figure>
<p>Cliquer sur «&nbsp;save&nbsp;»<br>Les informations apparaissent alors dans la commande.</p>
<figure class="image"><img src="/images/macro_centreon-7.png"></figure>
<p>Valider la création de la commande en cliquant sur «&nbsp;save&nbsp;»</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&nbsp;directement dans la CLI de centreon :&nbsp;</p>
<pre><code class="language-plaintext">./centreon_plugins.pl --plugin=os::windows::snmp::plugin --mode=list-interfaces --hostname=172.20.0.4 --snmp-community=**** --snmp-version=2c --interface= --name --oid-display=ifDesc --filter-status=up</code></pre>
<p>La liste des interfaces apparait il ne reste plus qu’à choisir l’interface ciblée&nbsp;</p>
<pre><code class="language-plaintext">List interfaces:
'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&nbsp;». 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 «&nbsp;Configuration&nbsp;» puis «&nbsp;Services&nbsp;» puis sur «&nbsp;Templates&nbsp;» et en fin sur «&nbsp;add&nbsp;»<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 «&nbsp;macros personnalisées&nbsp;» qui seront utilisées et définies</p>
<figure class="image"><img src="/images/macro_centreon-8.png"></figure>
<figure class="image"><img src="/images/macro_centreon-9.png"></figure>
<p>Cliquer sur «&nbsp;save&nbsp;» pour enregistrer la Template<br>Cliquer sur «&nbsp;Configuration&nbsp;» puis «&nbsp;Hosts&nbsp;» puis sur «&nbsp;Templates&nbsp;» et en fin sur «&nbsp;add&nbsp;»<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 «&nbsp;relations&nbsp;» choisir le Template de service précédemment créée pour l’associer avec ce Template d’host.</p>
<p>Cliquer sur «&nbsp;save&nbsp;» pour enregistrer le Template<br>Il ne reste plus qu’à associer ce Template avec un hôte.</p>