Vous êtes ici:

Menu


Stacks Image 29834
Les lignes de style Wearthermap sont disponibles dans Nagvis depuis la version 1.5. Ces lignes ont la possibilité d’afficher des lignes en couleur selon le résultat des sondes de supervision à la manière de PHP Weathermap. Pour cela nous aurons besoin de sonde avec un format de données de performances adapté à ces lignes.
La documentation Nagvis indique l'utilisation d'une sonde Perl s’appelant check_iftraffic3.pl. Celle-ci va écrire des données de performance exploitables par l’objet ligne « weathermap » de Nagvis. Nous aurons besoin de réaliser quelques modifications pour le rendre compatible avec notre maquette sous Centreon 18.10 avec Debian 9.
Nous verrons plus loin, comment utiliser les sondes Centreon avec les bonnes données de performances. Cette article a été mis à jour avec la version 1.9.11 de Nagvis.

1 Utilisation de la sonde check_iftraffic3.pl

1.1 prérequis

Tout d’abord, installez les paquets manquants au bon fonctionnement de check_iftraffic3.pl. L’hôte supervisé devra avoir le service SNMP fonctionnel.
apt-get install libnet-dns-perl

Récupérez le plugins perl check_iftraffic3.pl sur le site Nagios Exchange (c’est indiqué sur la documentation Nagvis) . Copiez celui-ci dans le dossier /usr/lib/nagios/plugin. Mettre les droits d’exécution et le propriétaire centreon-engine
chmod +x /usr/lib/nagios/plugins/check_iftraffic3.pl
chown centreon-engine: /usr/lib/nagios/plugins/check_iftraffic3.pl

Ce plugin utilise des fichiers temporaires pour les données de performance. A l’instar des plugins centreon, nous redirigerons ces fichiers vers un dossier spécifique dans /var/lib/centreon/centplugins. Modifiez le plugin et remplacez la ligne suivante
my $TRAFFIC_FILE = « /tmp/traffic »;

par
my $TRAFFIC_FILE = « /var/lib/centreon/centplugins/traffic »;

Notre plugin est prêt à fonctionner. Il va falloir l’intégrer dans Centreon. Connectons-nous à l’interface de Centreon. La configuration de Centreon va se dérouler en plusieurs étapes :
  • création d’une commande de plugin,
  • création d’un modèle,
  • création d’un service associé à un hôte.
Ensuite, après avoir appliquer la nouvelle configuration à Centreon, nous pourrons utiliser ce service avec Nagvis pour créer des lignes « weathermap ».

1.2 Création d’une commande de plugin

Sélectionnez le menu Configuration / commands / checks. Ajoutez une commande.
Stacks Image 43673
Création de la commande
Saisir la commande $USER1$/check_iftraffic3.pl -H $HOSTADDRESS$ -C $_HOSTSNMPCOMMUNITY$
  • $USER1$ étant le chemin des plugins
  • $HOSTADDRESS$ étant l’adresse IP ou DNS du nom de l’hôte associé
  • $_HOSTSNMPCOMMUNITY$ étant le nom de communauté SNMP de l'hôte
L’option Graph template n’est pas utilisé pour ce type de plugin.

1.3 Création d’un modèle (template)

Sélectionnez le menu Configuration / services / Templates. Ajoutez un modèle.
Stacks Image 43685
Création d'un modèle
Mettre le minimum d’information à savoir le nom du service, l’alias, le nom du template générique et le plus important le nom de la commande précédemment créée.
Stacks Image 43688
Association à un modèle d'hôte
Associer le modèle de service à un modèle d’hôte.

1.4 Création d’un hôte

Sélectionnez Configuration / Hosts / Add.
Stacks Image 43699
Création d'un hôte
Remplissez les champs suivants : Name, Alias, IP, SNMP et ajouté le modèle d'hôte associé à notre modèle. Vérifiez la prise en compte du service.
Stacks Image 43704
Les services ont été créés
Appliquez la configuration et vérifiez que vos services sont actifs. Voici les données de performances de cette sonde
Stacks Image 43763
Statut et données de performances du service
Et le graphe généré.
Stacks Image 43768
graphe du service

1.5 Création d’une carte Nagvis

Nous allons créer deux lignes de type Wearthermap : une avec des flèches et le pourcentage du traffic et l'autre avec des flèches, pourcentage et affichage du débit. Créons la première ligne.
Stacks Image 43714
Sélectionnez l'hôte et le service
Stacks Image 43717
Sélectionnez line et le type -%-><-%-
Pour la deuxième ligne, modifiez le deuxième onglet.
Stacks Image 43722
Sélectionnez line et le type -%+BW-><-%+BW-
Nous obtenons cette carte.
Stacks Image 43727
Exemple de cartographie
Nous utiliserons iperf pour réaliser nos tests.
Emetteur
iperf -c 10.0.3.167 -u -b 1000m -t 360
Récepteur
iperf -s -u
Et voici quelques exemples en fonction du débit des interfaces.
Stacks Image 43757
Stacks Image 43761
Stacks Image 43759

2 Utilisation des sondes Centreon Plugins

Nous utiliserons la dernière version du GitHub pour les utilisateurs de la version open-source ou les derniers plugins centreon version 20190111-102147 pour les utilisateurs des ISO Centreon. Pour l'installation des plugins Centreon voir l'article sur les plugins Centreon.

2.1 Création d’une commande de plugin

Sélectionnez le menu Configuration / commands / checks. Ajoutez une commande. Voici un exemple de mon cru avec les plugins du GitHub :
Stacks Image 43795
Création de la commande
Saisir la commande $CENTREONPLUGINS$/centreon_plugins.pl --plugin=os::linux::local::plugin --mode=traffic --speed=$_SERVICESPEED$ --name= --warning-out='$_SERVICEWARNING$' --critical-out='$_SERVICECRITICAL$' --warning-in='$_SERVICEWARNING$' --critical-in='$_SERVICECRITICAL$' $_SERVICEOPTIONS$
  • $CENTREONPLUGINS$ étant le chemin des plugins
  • $_SERVICESPEED$ indique la vitesse max de la carte réseau
  • $_SERVICEINTERFACE$ étant le nom de l'interface réseau
  • $_SERVICEWARNINGIN$ et $_SERVICEWARNINGOUT$ étant les seuils Warning du service
  • $_SERVICECRITICALIN$ et $_SERVICECRITICALOUT$ étant les seuils Critical du service
  • $_SERVICEOPTION$ étant une MACRO permettant d'ajouter des options non prévues.
L’option Graph template n’est pas utilisé pour ce type de plugin.

2.2 Création d’un modèle (template)

Sélectionnez le menu Configuration / services / Templates. Ajoutez un modèle.
Stacks Image 43804
Création d'un modèle
La chaine --units=% a été rajouté dans la macro OPTION, utile pour obtenir les pourcentages avec l'association de l'option speed.

2.3 Création d’un hôte

Comme le chapitre précédent, il faut créer un hôte avec ce service, nous obtiendrons ceci après application de la configuration.
Stacks Image 43818
Les services ont été créés
Stacks Image 43821
Statut et données de performances du service

2.4 Vérification du service sur une carte Nagvis

Nous allons tester ce service sur une cartographie Nagvis avec des lignes type Wearthermap : constatation aucune des ligne ne donnent satisfaction, il faut modifier les données de performances qui ne sont pas adaptées à ce type de ligne.
Stacks Image 43828
Exemple de cartographie
Nous allons utiliser les options change-perfdata, extend-perfdata et filter-data pour modifier la sortie des données de performances. Voici, un schéma explicatif de chaque option utilisée dans la commande de service pour obtenir le résultat voulu.
Stacks Image 43833
Utilisation des options change-perfdata, extend-perfdata et filter-data.

2.5 Modification du service pour la compatibilité Nagvis

Il faudra ajouter ces commandes dans la macro option.
--change-perfdata=traffic,target,,bps --extend-perfdata='target_(in|out),nagvis_$1L,percent()' --extend-perfdata='target_(in|out),nagvis_$1T,scale(auto)' --extend-perfdata=target,traffic --filter-perfdata='nagvis|traffic'
Stacks Image 43838
Modification du service
Appliquez la configuration et vérifiez le résultat dans Nagvis.
Stacks Image 43845
Les lignes sont opérationnelles
comments powered by Disqus
comments powered by Disqus
 Vous êtes ici: