Guide d’utilisation

Introduction

Présentation

En plus de la gestion des alertes, Vigilo sait gérer la remontée et le stockage des informations de performance du parc supervisé. La métrologie est ainsi collectée dans une base de données RRD et VigiGraph permet ensuite d’accéder aux graphes construits à partir de ces données. Il est possible de rechercher dans l’ensemble des données collectées, d’afficher les graphes correspondants, de les comparer entre eux, de zoomer, etc.

Les fonctions avancées offertes par VigiGraph permettent d’intégrer les actions préventives qui découlent des observations effectuées quotidiennement par les analystes du système, comme par exemple des mises à niveau de la capacité mémoire ou de serveurs faisant suite à des baisses de performances ou des saturations continues constatées sur certains équipements

Principales fonctionnalités

  • Menus de recherche sur tous les groupes, hôtes et indicateurs ;
  • Affichage de plusieurs graphes en simultané pour plusieurs hôtes ;
  • Possibilité pour chaque utilisateur de sauvegarder ses graphes ;
  • Menu de navigation au sein de chaque graphe : période, avant, arrière, zoom, etc.
  • Possibilité d’export CSV et d’impression.

Démarrage rapide

VigiGraph fournit une interface graphique accessible depuis un navigateur Web. La configuration par défaut est suffisante pour un démarrage rapide.

Accès à l’interface

L’utilisation de VigiGraph se fait simplement en accédant, via votre navigateur, à l’adresse indiquée par votre administrateur. Par exemple : http://supervision.example.com/vigigraph/.

Authentification

Note

Dans le cas où un mécanisme d’authentification externe a été défini par votre administrateur, il se peut qu’aucune authentification ne vous soit demandée, même lorsqu’il s’agit de votre première connexion. Le reste de ce chapitre décrit le cas où une authentification interne a lieu et ne s’applique donc pas au cas de figure cité ci-dessus. Contactez votre administrateur pour plus d’information sur la configuration utilisée.

Si vous ne vous êtes jamais connecté sur VigiGraph ou si vous n’êtes plus authentifié, le formulaire d’authentification de la figure suivante s’affiche:

../../../_images/login_form1.png

Écran d’authentification.

Selon le compte utilisateur auquel vous vous connecterez, vous disposerez d’un accès à plus ou moins d’hôtes et de services (et donc d’informations). Les données d’authentification demandées ici vous ont normalement été transmises par votre administrateur.

  • Saisir les données d’authentification en renseignant les zones de saisie « Identifiant » et « Mot de passe ».
  • Valider la saisie en cliquant sur le bouton « Connexion » (entouré en rouge sur la figure suivante).
../../../_images/login_form_connection1.png

Bouton de validation des données d’authentification.

En cas de succès, la page d’accueil s’affiche. Sinon, le formulaire d’authentification s’affiche à nouveau, avec un message précisant la nature de l’erreur:

../../../_images/login_failure1.png

Formulaire après un échec de l’authentification.

Fonctionnalités

Page d’accueil

Une fois la page d’authentification passée, la page d’accueil s’affiche, comme comme sur la figure qui suit. Il s’agit de l’interface principale de VigiGraph.

../../../_images/homepage.png

Page d’accueil.

Cette page permet à la fois la recherche, la visualisation, et l’impression des graphes.

Sélection d’un hôte

L’accès à la plupart des fonctionnalités de VigiGraph nécessite que le champ « Hôte » de la barre de sélection soit renseigné.

../../../_images/selection_bar.png

Barre de sélection.

Après un premier clic sur le bouton « Sélectionner un hôte », une boîte de dialogue permet de choisir l’hôte souhaité parmi l’arborescence des groupes configurés dans Vigilo.

../../../_images/select_host.png

Sélection de l’hôte.

Sélection d’un graphe à afficher

Une fois un hôte sélectionné, le bouton « Sélectionner un graphe » devient actif.

Un clic sur ce bouton permet de choisir un graphe à afficher parmi la liste de graphes diponibles pour cet hôte. La fenêtre de visualisation s’ouvre alors, comme le montre l’illustration suivante :

../../../_images/graph_window.png

Affichage du graphe après sélection de l’hôte et du graphe.

Cette fenêtre est décrite plus en détail dans la section Visualisation d’un graphe.

Note

Il est tout à fait possible de sélectionner plusieurs graphes de plusieurs hôtes pour un affichage simultané.

Recherche

Cette fenêtre permet de rechercher parmi la liste des couples Hôtes/Graphes disponibles. L’activation s’effectue par un clic sur l’icône en forme de loupe loupe située en haut à droite de l’interface.

La fenêtre de recherche se présente au départ comme sur l’illustration suivante :

../../../_images/search_form_empty.png

État initial du formulaire de recherche.

Les caractères « ? » et « * » permettent de représenter un caractère quelconque ou une suite de caractères quelconques, respectivement.

Un clic sur le bouton « Rechercher » provoque l’affichage de la liste complète des couples Hôtes/Graphes déclarés en base de données et correspondant aux motifs de recherche saisis.

Si aucun texte n’a été saisi dans le champ « Hôte » et le champ « Graphe », la liste complète de tous les couples Hôtes/Graphes disponibles est affichée.

../../../_images/search_form_all.png

Liste de tous les graphes disponibles.

Les champs de saisie « Hôte » et « Graphe » permettent la saisie de critères de recherche sur un serveur ou un graphe particulier.

../../../_images/search_form_graph.png

Recherche des graphes portant sur une partition.

et/ou :

../../../_images/search_form_host.png

Recherche parmi les hôtes.

Les deux critères peuvent être combinés afin de n’afficher que certains graphes d’un ensemble d’hôtes.

La sélection d’un élément de cette liste est possible par un clic sur la ligne correspondante. Ce clic provoque l’actualisation de la fenêtre « Sélection d’un hôte » afin de sélectionner l’hôte (et éventuellement le graphe) cliqué. Si l’élément cliqué correspond à un graphe, le graphe est affiché à l’écran, comme sur l’illustration suivante :

../../../_images/search_click_graph.png

Affichage d’un graphe suite à un clic dans la fenêtre de recherche.

Visualisation d’un graphe

L’affichage des graphes s’effectue dans une fenêtre distincte, semblable à celle présentée dans l’illustration suivante :

../../../_images/graph_window.png

Fenêtre de visualisation d’un graphe.

Cette fenêtre comporte :

  • une barre de titre rappelant le nom de l’hôte et du graphe affiché ;
  • des boutons de gestion de l’affichage du graphe ;
  • la zone d’affichage à proprement parler.

Le graphe donne l’évolution des valeurs dans le temps, avec un intervalle de temps par défaut qui couvre les dernières 24 heures.

L’utilisateur peut modifier cette durée en cliquant sur les boutons plus et plus.

Ceci provoque le rafraîchissement des données sur une durée respectivement diminuée ou agrandie avec un facteur 2.

La sélection de la plage de temps est aussi possible :

  • par un clic sur un des boutons plage de début, plage précédente, plage suivante, et plage de fin (respectivement plage de début, plage précédente, plage suivante et plage de fin) ;

  • ou par un choix dans la liste obtenue après un clic sur le bouton « Période » période.

    Ceci provoque le rafraîchissement des données sur la durée courante.

Dans l’illustration, le bouton plage de début a été utilisé afin de se replacer au tout début de la période d’enregistrement. Partant de cette situation, l’utilisation du bouton plage suivante donne par exemple le graphe suivant :

../../../_images/graph_window2.png

Progression dans le temps.

Le tableau suivant liste l’ensemble des boutons disponibles dans la fenêtre de visualisation, et détaille leur fonctionnement :

Liste des boutons
Bouton Intitulé de la bulle d’aide Détail
rechargement Recharger le graphe

Rafraîchissement automatique du graphe selon la fréquence configurée :

  • bouton enfoncé → rafraîchissement automatique
  • bouton relâché → pas de rafraîchissement
période Menu de choix de la période Rafraîchissement du graphe avec adaptation à la plage de temps
plage de début Début du graphe Rafraîchissement du graphe avec les valeurs de la première plage de temps
plage précédente Section précédente Rafraîchissement du graphe avec les valeurs de la plage de temps précédente
plage suivante Section suivante Rafraîchissement du graphe avec les valeurs de la plage de temps suivante
plage de fin Fin du graphe Rafraîchissement du graphe avec les valeurs de la dernière plage de temps
plus Zoomer Rafraîchissement du graphe avec agrandissement de la plage de temps (x 2)
plus Dézoomer Rafraîchissement du graphe avec diminution de la plage de temps (/ 2)
export Export CSV Export du graphe
impression Imprimer le graphe Impression du graphe

Consultation d’une page de supervision

Cette fonctionnalité permet de consulter la page Nagios de l’hôte actuellement sélectionné (voir la section Sélection d’un hôte).

L’activation s’effectue par un clic sur le bouton « Liens externes » dans la barre de sélection de l’hôte, suivi par un clic sur le bouton « Page Nagios ».

L’affichage s’effectue dans une page distincte, comme le montre l’illustration suivante :

../../../_images/nagios_page.png

Exemple d’une page de supervision Nagios.

Consultation de l’ensemble des graphes de métrologie d’un hôte

Cette fonctionnalité permet de consulter l’ensemble des graphes de métrologie de l’hôte actuellement sélectionné (voir la section Sélection d’un hôte).

L’activation s’effectue par un clic sur le bouton « Liens externes » dans la barre de sélection de l’hôte, suivi par un clic sur le bouton « Page de métrologie ».

L’affichage s’effectue dans une page distincte, comme le montre l’illustration suivante :

../../../_images/metrology_page.png

Vue synthétique de tous les graphes d’un hôte.

Impression d’un graphe

Cette fonctionnalité permet d’imprimer le graphe courant, tel qu’il est actuellemnet présenté à l’écran.

L’activation de l’impression s’effectue par un clic sur le bouton impression de la fenêtre de visualisation du graphe.

Une fenêtre d’impression s’affiche alors.

../../../_images/print_dialog.png

Fenêtre d’impression d’un graphe.

Après renseignement des paramètres d’impression et validation, cette fenêtre se referme et l’impression commence.

Note

Si plusieurs graphes sont affichés à l’écran au moment de l’activation de l’impression, ils seront tous imprimés.

Export d’un graphe

Cette fonctionnalité permet d’exporter le graphe courant.

L’activation de l’export s’effectue par un clic sur le bouton export de la fenêtre de visualisation du graphe, suivi par un clic sur nom de l’indicateur à exporter (ou sur le label « Tous » pour exporter simultanément tous les indicateurs du graphe).

La fenêtre d’export s’affiche alors, comme sur l’illustration suivante :

../../../_images/export_dialog.png

Fenêtre de sauvegarde des données exportées.

Une fois l’une des options validée, la fenêtre se referme. Le fichier généré est consultable à l’aide d’un tableur. Le contenu se présente comme suit :

../../../_images/oocalc.png

Données exportées vues dans un tableur.

La sortie par défaut d’un fichier au format CSV se caractérise comme suit :

  • Les valeurs sont entourées par des guillemets droits (”) et séparées par des points virgules (;).
  • Le contre-oblique () est utilisé en tant que caractère d’échappement.
  • La première ligne du fichier contient un en-tête composé des libellés des champs dans leur ordre d’apparition (« Timestamp » puis l’indicateur ou la série d’indicateurs exportés).
  • Les lignes suivantes correspondent aux valeurs de chaque indicateur à l’instant identifié par la valeur de la colonne « Timestamp ».
  • Les lignes sont triées par ordre chronologique croissant.

L’administrateur peut choisir de paramétrer différemment l’export (notamment les caractères utilisés pour la séparation des valeurs, leur délimitation ou le caractère d’échappement). Consultez votre administrateur afin de connaître le format exact des fichiers générés.

Rafraîchissement automatique d’un graphe

Cette fonctionnalité permet de réactualiser un graphe périodiquement.

La période figure dans un fichier de configuration ; elle est exprimée en secondes. Par défaut, elle est initialisée à 30 secondes. Cette donnée n’est pas modifiable via l’application. Elle est gérée par l’administrateur système.

L’activation s’effectue par un clic sur le bouton rafraîchissement automatique de la fenêtre de visualisation du graphe. Le bouton apparaît alors enfoncé.

La désactivation s’effectue aussi par un clic sur le même bouton. Celui-ci apparaît alors relâché. L’illustration suivante présente l’état du bouton selon que le rafraîchissement automatique est activé ou non :

../../../_images/auto_refresh.png

Illustration : Rafraîchissement automatique activé (à gauche) et désactivé (à droite)

Un bouton global rafraîchissement automatique global permet également d’activer ou de désactiver le rafraîchissement automatique sur l’ensemble des graphes visibles à l’écran.

Le comportement de ce bouton est similaire à celui du bouton positionné sur chaque fenêtre de graphe : un clic permet d’activer le rafraîchissement (le bouton apparaît alors enfoncé), un nouveau clic désactive le rafraîchissement (le bouton apparaît alors relâché).

Sauvegarde de l’affichage

Cette fonctionnalité permet de sauvegarder un ensemble de graphes affichés à l’écran pour des opérations ultérieures.

La sauvegarde s’effectue via le navigateur, en ajoutant un marque-page. Par exemple, sous Firefox :

  • Cliquer sur le menu « Marque-Pages ».
  • Choisir l’option « Marquer cette page ».
  • Saisir un nom pour le marque-page (ou laisser la valeur par défaut).
  • Choisir un dossier de destination (par exemple « Barre personnelle »).
  • Valider par un clic sur le bouton « Terminer ».

Le rappel de la sélection s’effectue également via le navigateur ; par exemple, sous Firefox :

  • Cliquer sur le menu « Marque-Pages ».
  • Sélectionner l’élément créé précédemment lors de l’ajout du marque-page .

Moteur de recherche

En plus de la fonctionnalité de recherche accessible directement depuis la page d’accueil (voir la section Recherche), VigiGraph est livré avec un moteur de recherche qui peut être utilisé directement depuis la barre de recherche de votre navigateur.

La procédure qui suit décrit l’ajout et l’utilisation de ce moteur de recherche depuis Firefox ; dans le cas où vous souhaiteriez utiliser un autre navigateur pour accéder à VigiGraph, reportez-vous au manuel dudit navigateur pour savoir comment adapter cette procédure.

Pour enregistrer le moteur de recherche sous Firefox (cette manipulation n’est à effectuer qu’une seule fois) :

  • Cliquer sur le bouton à gauche de la zone des moteurs de recherche. → La liste des moteurs actuellement enregistrés s’affiche, ainsi que des actions possibles.
  • Cliquer sur la ligne « Ajouter “Recherche Vigilo” ». → Le moteur de recherche de VigiGraph est ajouté à la liste des moteurs de recherche disponibles et la liste disparaît de l’écran.

Une fois le moteur de recherche enregistré, il apparaît dans le navigateur sous la forme d’une zone de saisie.

Pour effectuer une recherche :

  • Cliquer sur le bouton à gauche et choisir « Recherche Vigilo » (représenté par l’icône de Vigilo : un œil vert) dans la liste des moteurs de recherche.
  • Saisir un intitulé dans la zone de saisie.
  • Cliquer sur le bouton en forme de loupe à droite ou valider à l’aide de la touche « Entrée ».
→ Une page présentant des informations sur les serveurs répondant à la requête
s’affiche alors.

Un exemple de résultats obtenus lors de la recherche du terme « local » est présenté sur l’illustration suivante :

../../../_images/opensearch_results.png

Résultat de l’utilisation du moteur de recherche.

Dans cette page, sur chaque ligne, figurent :

Un clic sur l’un de ces liens remplace la page courante par la page demandée.

Résolution de problèmes

Annexes

Glossaire - Terminologie

Ce chapitre recense les différents termes techniques employés dans ce document et donne une brève définition de chacun de ces termes.

API
Interface logicielle de programmation, permettant à un développeur d’enrichir la liste des fonctionnalités proposées par un logiciel.
CGI
Interface standard de communication entre un serveur web et un programme capable de générer une réponse HTTP valide. Il s’agit par exemple de l’interface retenue par Nagios (< 3.3) pour la génération de ses pages web.
CSS
Feuilles de styles permettent de modifier la représentation graphique des éléments d’une page web. La version généralement supportée par les navigateurs est la version 2, définie par le document disponible sur http://www.w3.org/TR/CSS2/.
CSV
À l’origine, désigne un format textuel de transfert de données dans lequel les entrées sont séparées par des retours chariot et les champs par des virgules (comma). De nos jours, désigne plus généralement un format tabulé pour l’échange de données en vue de leur traitement dans un logiciel de type tableur ou par un traitement automatisé (scripts).
DN
Identifiant unique dans le cadre d’un annuaire LDAP.
Événement brut
Alerte envoyée par Nagios au corrélateur de Vigilo pour analyse.
Événement corrélé
Incident détecté par Vigilo suite à la corrélation des alertes Nagios (évènements bruts). Un événement corrélé est causé par un unique événement brut (exemple : la panne d’un routeur), mais de nombreux autres évènements bruts peuvent lui être rattachés (exemple : les alertes indiquant que les serveurs situés derrière le routeur en panne sont indisponibles). Ces événements secondaires rattachés à l’événement corrélé sont alors appelés « événements bruts masqués ».
KDC
Serveur permettant un transfert sécurisé des clés de chiffrement utilisées pour les communications entre divers services. Ce serveur est notamment utilisé lors des échanges initiaux du protocole Kerberos.
LDAP
Protocole pour l’interrogation d’un annuaire, servant généralement à recenser les utilisateurs autorisés d’un système et les différentes propriétés associées à ces utilisateurs.
OS
Système d’exploitation.
Nagios
Composant libre de supervision système et réseau.
RRD
Base de données de taille fixe utilisant des fichiers circulaires, dont les données sont progressivement compressées (avec perte) au fur et à mesure de leur vieillissement.
RRDtool
Composant libre de gestion de bases RRD (stockage, restitution, génération de graphiques).
SGBD[R]
Logiciel permettant d’héberger des bases de données [relationnelles] sur une machine.
SQL
Langage de requêtes structuré pour l’interrogation d’une base de données relationnelle.
URL
Chaîne de caractères permettant d’identifier une ressource, par exemple une page web sur Internet. Exemple : http://www.vigilo-nms.com/
WSGI
Une interface pour la communication entre une application et un serveur web, similaire à CGI. Il s’agit de l’interface utilisée par Vigilo.

Liste des URL

Le tableau suivant recense les URL disponibles dans VigiGraph. Les paramètres obligatoires de l’URL sont indiqués en gras (dans la colonne du milieu).

Liste des URL
Fonctionnalité URL Détail
Interface principale <prefix_url>/ L’interface principale d’accès à VigiGraph s’affiche.
Recherche d’un hôte ou d’un ensemble d’hôtes. <prefixe_url>/rpc/searchHost?**query**=intitulé_query> VigiGraph affiche l’ensemble des hôtes dont le nom contient <intitulé_query>, sans distinction majuscules/minuscules.
Image d’un graphe au format PNG. <prefixe_url>/rpc/getImage_png?**host**=<intitulé_host>&**graph**=<intiulé_graph>&start=<intitulé_start>&duration=<intitulé_duration> Paramètres : - <intitulé_host> = serveur cible - <intitulé_graph> = graphe - <intitulé_start> = date-heure de début du graph - <intitulé_duration> = durée du graphe
Export CSV. <prefixe_url>/rpc/exportCSV?**host**=<intitulé_host>&**indicator**=<intitulé_indicator>

Paramètres :

  • <intitulé_host> = serveur cible
  • <intitulé_indicator> = indicateur associé à un graphe

Particularités :

  • Pour un export sur l’ensemble des indicateurs, <intitulé_indicator> est renseigné avec la chaîne « all».

Exemple : localhost:8082/rpc/exportCSV?host=par.linux0&indicator=IO%20Reads

Les intitulés du type ... permettent le paramétrage de l’URL. Ils sont de type chaîne de caractères.