Introduction

NagVis est un logiciel Open Source qui permet de visualiser sous forme de cartes les données tirées de différents outils de supervision: Shinken, Nagios, Centreon... (http://nagvis.org/about)


A partir de la version V02.05.00, lors de l'installation ou la mise à jour de Shinken Entreprise, une installation NagVis est installée automatiquement. Puisque NagVis est régulièrement installé en parallèle de Shinken afin de visualiser le statut des hôtes sur des représentations graphiques avancées et personnalisées, une instance de NagVis est automatiquement installée avec Shinken Entreprise.

Cette installation permet notamment d'éviter à l'utilisateur de devoir configurer NagVis pour le lier avec Shinken, puisque l'instance de NagVis installée est aussi préconfigurée.

Les sections suivantes décrivent comment manipuler cette installation NagVis, ainsi que la configuration par défaut disponible.

Manipulation


Lorsque l'addon est activé, NagVis sera disponible sur la machine correspondante à l'adresse suivante:

http://ip_machine/shinken-map



L'instance de NagVis installée par l'installeur Shinken Entreprise est présentée sous la forme d'un addon "nagvis".

Cette addon peut être activé et désactivé grâce aux commandes d'Activation/désactivation des addons.

L'activation de l'addon "nagvis" effetue les opérations suivantes:

  • Activation du module Livestatus dans le Broker, pour permettre à NagVis de communiquer avec Shinken (seulement lorsqu'on exécute la commande d'activation sur la machine de l'Arbiter).
  • Activation de NagVis au niveau de Apache, pour permettre à l'interface Web de NagVis d'être accessible

La désactivation de l'addon effectue les opérations suivantes:

  • Désactivation de NagVis au niveau d'Apache, pour que l'interface Web ne soit plus accessible
  • Le module Livestatus n'est pas désactivé sur le Broker car il est possible que d'autres outils aient besoin d'utiliser Livestatus.


  • Puisque les commandes d'activation/désactivation effectuent des modifications de la configuration des démons, il faut les exécuter sur le serveur central (celui contenant l'Arbiter) pour que les modifications de la configuration soient prises en compte
  • Aussi, puisque ces commandes effectuent des modifications de configuration locales à la machine (changement de paramètres Apache), il faudra aussi les exécuter sur localement sur la machine ou l'on veut activer l'addon.


Configuration par défaut

Un des intérêts principaux de NagVis est de pouvoir être relié à un logiciel de supervision (en l'occurence Shinken) pour récupérer le statut des hôtes et des checks.

L'addon "nagvis" vient donc avec une version de NagVis préconfigurée pour éviter d'avoir à effectuer ces réglages manuellement.

Récupération des statuts dans Shinken

NagVis doit être relié à un "backend" pour pouvoir récupérer les statuts des hôtes et checks. Dans le cadre de Shinken, cette liaison avec NagVis s'effectue via le module Livestatus du Broker. Ce module est automatiquement activé lorsque l'addon est activé avec la commande d'activation des addons (voir section précédente).


Par défaut, NagVis va récupérer les statuts des éléments de Shinken sur le Broker situé sur la machine sur laquelle il est installé (127.0.0.1), en utilisant le port de Livestatus par défaut (50000). Si un Broker doit être utilisé, les paramètres du backend peuvent être configurés directement dans NagVis, par l'interface Graphique ou bien via le fichier de configuration de NagVis.




...
[backend_shinken_livestatus]
backendtype="mklivestatus"
socket="tcp:127.0.0.1:50000"
...


Liaison de l'authentification avec Shinken