vigigraph / doc / util.rst @ f6e5b0c6
History | View | Annotate | Download (31.5 KB)
1 | 101a8e79 | Francois POIROTTE | ******************** |
---|---|---|---|
2 | Guide d'utilisation |
||
3 | ******************** |
||
4 | |||
5 | Description générale de l'application |
||
6 | ##################################### |
||
7 | |||
8 | Présentation |
||
9 | ============ |
||
10 | L'objectif de VigiGraph est de fournir une interface unifiée d'accès à |
||
11 | l'ensemble des applications web de supervision et de métrologie (Nagios, |
||
12 | VigiRRD), alors même que ces interfaces sont réparties sur plusieurs serveurs. |
||
13 | Il s'agit de l'une des deux interfaces directement utilisées en permanence |
||
14 | par le personnel chargé d'assurer la surveillance des systèmes à superviser. |
||
15 | Cette interface permet, en quelques clics, d'afficher les données de supervision relatives à un serveur ou des graphiques de métrologie correspondants, sur des plages de temps aisément paramétrables. |
||
16 | Pour les graphiques, l'impression et l'export (sous forme de fichier CSV) sont de plus possibles. |
||
17 | |||
18 | Principales données accessibles |
||
19 | =============================== |
||
20 | VigiGraph accède aux données suivantes : |
||
21 | |||
22 | - des données de configuration : dans les fichiers de configuration, |
||
23 | - des données de métrologie : dans les fichiers RRD, |
||
24 | - des données de supervision : Nagios, |
||
25 | - des données diverses : en Base de Données (Groupes, Serveurs, Graphes, Utilisateurs, …). |
||
26 | |||
27 | |||
28 | Services annexes |
||
29 | ================ |
||
30 | Néant. |
||
31 | |||
32 | Utilisateurs |
||
33 | ============ |
||
34 | |||
35 | Authentification d'un utilisateur |
||
36 | --------------------------------- |
||
37 | Un utilisateur s'authentifie à l'aide de deux informations : un identifiant et un mot de passe. |
||
38 | |||
39 | Utilisation de l'application |
||
40 | ############################ |
||
41 | |||
42 | Configuration pré-requise |
||
43 | ========================= |
||
44 | L'application s'utilise via un navigateur web, au travers d'une adresse internet (URL). Cette adresse vous a été transmise par votre administrateur. |
||
45 | Le reste de ce document présente des captures d'écran réalisées sous Mozilla Firefox 3.6. D'autres navigateurs ou d'autres versions du navigateur Mozilla Firefox peuvent également être utilisés. Certaines fonctionnalités font appel à des outils intégrés au navigateur (marque-pages, moteurs de recherche, …) et peuvent ne pas être disponibles sur votre navigateur ou nécessiter une légère adaptation. |
||
46 | |||
47 | Procédure de connexion |
||
48 | ====================== |
||
49 | |||
50 | - Sur le Poste Client, lancer le navigateur web |
||
51 | → la page d'accueil du navigateur s'affiche |
||
52 | |||
53 | .. figure:: img/address_bar.png |
||
54 | |||
55 | Navigateur web au démarrage. |
||
56 | |||
57 | |||
58 | - Dans la zone de saisie de l'adresse de cette fenêtre (zone entourée sur la copie d'écran), tapez l'adresse du serveur web qui héberge VigiGraph. Il s'agit de l'adresse que votre administrateur vous a transmis pour l'accès à VigiGraph. |
||
59 | Exemple : http://supervision.example.com/vigigraph/ |
||
60 | - Valider en appuyant sur la touche « Entrée » |
||
61 | → Si vous ne vous êtes jamais connecté sur VigiGraph ou si vous n'êtes plus authentifié, le formulaire d'authentification de l'illustration s'affiche. |
||
62 | |||
63 | |||
64 | .. note:: |
||
65 | |||
66 | Dans le cas où un mécanisme d'authentification externe a été défini par votre |
||
67 | administrateur, il se peut qu'aucune authentification ne vous soit demandée, même lorsqu'il |
||
68 | s'agit de votre première connexion. Le reste de cette section décrit le cas où une |
||
69 | authentification interne a lieu et ne s'applique donc pas au cas de figure cité ci-dessus, |
||
70 | l'application vous authentifiant automatiquement grâce à d'autres informations. |
||
71 | Contactez votre administrateur pour plus d'information. |
||
72 | |||
73 | |||
74 | - Saisir les données d'authentification en renseignant les zones de saisie « Identifiant » et « Mot de passe ». |
||
75 | - Valider la saisie en cliquant sur le bouton « Connexion » (entouré en rouge sur l'illustration ). |
||
76 | |||
77 | → En cas de succès, la page principale de VigiGraph s'affiche, comme sur l'illustration . |
||
78 | |||
79 | .. figure:: img/homepage.png |
||
80 | |||
81 | Page principale de VigiGraph. |
||
82 | |||
83 | |||
84 | |||
85 | Cette page comporte en particulier un formulaire de saisie : la fenêtre de sélection d'hôte. Cette dernière est destinée à la saisie d'informations sur les groupes, serveur cible et graphe que l'on souhaite représenter. |
||
86 | |||
87 | → En cas d'erreur, le formulaire d'authentification s'affiche à nouveau, avec un message expliquant l'origine de l'erreur, comme sur l'illustration . L'utilisateur peut alors tenter de s'authentifier à nouveau. |
||
88 | |||
89 | .. figure:: img/login_failure.png |
||
90 | |||
91 | Formulaire après un échec de l'authentification. |
||
92 | |||
93 | |||
94 | |||
95 | |||
96 | Procédure de déconnexion |
||
97 | ======================== |
||
98 | Cliquer sur le bouton « Déconnexion » |
||
99 | .. image:: img/logout_button.png |
||
100 | |||
101 | de VigiGraph |
||
102 | → La page en cours est remplacée par le formulaire d'authentification |
||
103 | et un message s'affiche vous indiquant que vous avez bien été déconnecté |
||
104 | de l'application. |
||
105 | |||
106 | Fonctionnalités |
||
107 | ############### |
||
108 | Les fonctionnalités suivantes sont supportées : |
||
109 | |||
110 | - Recherche |
||
111 | - Consultation d'un graphe |
||
112 | - Consultation d'une page de supervision |
||
113 | - Consultation de l'ensemble des graphes d'un hôteImpression d'un graphe |
||
114 | - Export d'un graphe |
||
115 | - Rafraîchissement automatique d'un graphe |
||
116 | - Impression de graphes |
||
117 | - Moteur de recherche |
||
118 | |||
119 | |||
120 | Sélection d'un hôte / graphe |
||
121 | ============================ |
||
122 | L'accès à certaines des fonctionnalités de VigiGraph nécessite que les champs de la barre de sélection soient renseignés. Les champs pouvant être modifiés sont ceux qui disposent d'une flèche pointant vers le bas |
||
123 | .. image:: img/100000000000000E000000106713413D.png |
||
124 | |||
125 | sur leur droite. Ces champs apparaissent cerclés de rouge sur l'illustration qui suit. |
||
126 | Illustration : Barre de sélection au chargement de la page |
||
127 | |||
128 | |||
129 | Sur un clic sur le bouton « Sélectionner un hôte » (dont l'info-bulle d'aide est « Cliquez-moi pour sélectionner un autre hôte »), une boîte de dialogue s'ouvre permettant la sélection de l'hôte (éléments représentés par une icône en forme de fichier |
||
130 | .. image:: img/100000000000000E00000012BEE43A48.png |
||
131 | |||
132 | ) à partir des différents groupes disponibles (éléments représentés par une icône en forme de dossier |
||
133 | .. image:: img/10000000000000100000000F6D394F30.png |
||
134 | |||
135 | , comme dans l'illustration qui suit: |
||
136 | |||
137 | .. figure:: img/select_host.png |
||
138 | |||
139 | Sélection de l'hôte. |
||
140 | |||
141 | |||
142 | |||
143 | Une fois l'hôte sélectionné, le champ « Sélectionner un graphe » (dont l'info-bulle d'aide est « Cliquez-moi pour sélectionner un autre graphe ») devient actif. Un clic sur ce bouton permet de sélectionner un graphe, en suivant la même procédure que pour la sélection de l'hôte. |
||
144 | Lorsque ce second champ est rempli, le graphe sélectionné est alors automatiquement affiché comme sur l'illustration . |
||
145 | |||
146 | .. figure:: img/graph_window.png |
||
147 | |||
148 | Affichage du graphe après sélection de l'hôte et du graphe. |
||
149 | |||
150 | |||
151 | Le renseignement de chacun des champs constitutifs de cette fenêtre s'effectue par choix dans une liste établie d'après les valeurs présentes en base de données. |
||
152 | |||
153 | Recherche |
||
154 | ========= |
||
155 | Cette fenêtre permet l'affichage de la liste des couples Hôtes - Graphes. |
||
156 | L'activation s'effectue par un clic sur l'icône en forme de loupe |
||
157 | .. image:: img/100002010000001800000018D51A653F.png |
||
158 | |||
159 | située en haut à droite de l'interface et cerclée de rouge sur l'illustration suivante (l'info-bulle d'aide de l'icône est « Rechercher un hôte/graphe particulier »). |
||
160 | Illustration : Bouton de recherche d'hôtes/graphes |
||
161 | |||
162 | |||
163 | La fenêtre de recherche se présente comme sur l'illustration au départ : |
||
164 | |||
165 | .. figure:: img/search_form_empty.png |
||
166 | |||
167 | État initial du formulaire de recherche. |
||
168 | |||
169 | |||
170 | Les caractères « ? » et « * » permettent de représenter un caractère quelconque ou une suite de caractères quelconques, respectivement. |
||
171 | 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. |
||
172 | 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. Ceci est équivalent à la saisie du texte « * » dans le champ « Graphe ». |
||
173 | |||
174 | .. figure:: img/search_form_all.png |
||
175 | |||
176 | Liste de tous les graphes disponibles. |
||
177 | |||
178 | |||
179 | Les champs de saisie « Hôte » et « Graphe » permettent la saisie de critères |
||
180 | de recherche sur un serveur ou un graphe particulier. |
||
181 | |||
182 | .. figure:: img/search_form_graph.png |
||
183 | |||
184 | Recherche des graphes portant sur une partition. |
||
185 | |||
186 | |||
187 | et/ou : |
||
188 | |||
189 | .. figure:: img/search_form_host.png |
||
190 | |||
191 | Recherche parmi les hôtes. |
||
192 | |||
193 | |||
194 | Les deux critères peuvent être combinés ensemble afin de n'afficher que certains graphes d'un ensemble d'hôtes. |
||
195 | 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 . |
||
196 | |||
197 | .. figure:: img/search_click_graph.png |
||
198 | |||
199 | Affichage d'un graphe suite à un clic dans la fenêtre de recherche. |
||
200 | |||
201 | |||
202 | Un clic sur le bouton |
||
203 | .. image:: img/100000000000001000000010D02CC003.png |
||
204 | |||
205 | en haut à droite de la fenêtre de recherche provoque la fermeture de cette fenêtre. |
||
206 | |||
207 | Consultation d'un graphe |
||
208 | ======================== |
||
209 | Cette fonctionnalité permet de consulter un graphe. Elle se rapporte au serveur et au graphe sélectionnés dans la barre de sélection (voir chapitre ). Les données exploitées sont extraites des fichiers RRD. |
||
210 | L'affichage s'effectue dans une boîte de dialogue distincte, comme présenté dans l'illustration . |
||
211 | |||
212 | .. figure:: img/graph_window.png |
||
213 | |||
214 | Affichage du graphe dans une nouvelle fenêtre. |
||
215 | |||
216 | |||
217 | 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. |
||
218 | L'utilisateur peut modifier cette durée en cliquant sur les boutons |
||
219 | .. image:: img/1000020100000010000000106B00FCEC.png |
||
220 | |||
221 | et |
||
222 | .. image:: img/100002010000001000000010042272EB.png |
||
223 | |||
224 | . Ceci provoque le rafraîchissement des données sur une durée respectivement diminuée ou agrandie avec un facteur 2. |
||
225 | La sélection de la plage de temps est aussi possible : |
||
226 | |||
227 | - par un clic sur un des boutons |
||
228 | .. image:: img/100002010000001000000010301CF203.png |
||
229 | |||
230 | , |
||
231 | .. image:: img/100002010000001000000010CB569423.png |
||
232 | |||
233 | , |
||
234 | .. image:: img/1000020100000010000000107ABC8922.png |
||
235 | |||
236 | et |
||
237 | .. image:: img/10000201000000100000001018DF7CB8.png |
||
238 | |||
239 | (respectivement plage de début, plage précédente, plage suivante et plage de fin) ; |
||
240 | - ou par un choix dans la liste obtenue après un clic sur le bouton |
||
241 | .. image:: img/1000020100000010000000109787A6BD.png |
||
242 | |||
243 | « Période ». |
||
244 | Ceci provoque le rafraîchissement des données sur la durée courante. |
||
245 | |||
246 | Dans l'illustration , le bouton |
||
247 | .. image:: img/100002010000001000000010301CF203.png |
||
248 | |||
249 | a été utilisé afin de se replacer au tout début de la période d'enregistrement. |
||
250 | Partant de cette situation, l'utilisation du bouton |
||
251 | .. image:: img/1000020100000010000000107ABC8922.png |
||
252 | |||
253 | donne par exemple le graphe suivant (illustration ) : |
||
254 | |||
255 | .. figure:: img/graph_window2.png |
||
256 | |||
257 | Progression dans le temps. |
||
258 | |||
259 | |||
260 | Un clic sur le bouton |
||
261 | .. image:: img/100000000000001000000010D02CC003.png |
||
262 | |||
263 | en haut à droite de la fenêtre du graphe provoque la fermeture de cette fenêtre. |
||
264 | |||
265 | Consultation d'une page de supervision |
||
266 | ====================================== |
||
267 | Cette fonctionnalité permet de consulter les données Nagios. Elle se rapporte à l'hôte actuellement sélectionné (voir chapitre ). |
||
268 | L'activation s'effectue par un clic sur le bouton « Page Nagios » dans la barre de sélection d'un hôte, cerclé de rouge sur l'illustration qui suit. L'intitulé de l'info-bulle d'aide est « Affiche la page Nagios de l'hôte sélectionné ». |
||
269 | Cette visualisation n'est possible qu'après renseignement des trois premiers champs de la fenêtre. |
||
270 | |||
271 | Illustration : Bouton de consultation de la page Nagios de supervision associée à un hôte |
||
272 | |||
273 | |||
274 | L'affichage s'effectue dans une page distincte. Un exemple de ce type de page est donné par l'illustration . |
||
275 | |||
276 | .. figure:: img/nagios_page.png |
||
277 | |||
278 | Exemple d'une page de supervision Nagios. |
||
279 | |||
280 | |||
281 | |||
282 | Consultation de l'ensemble des graphes de métrologie d'un hôte |
||
283 | ============================================================== |
||
284 | Cette fonctionnalité permet de consulter l'ensemble des graphes de métrologie |
||
285 | d'un hôte. Elle se rapporte à l'hôte actuellement sélectionné (voir chapitre ). |
||
286 | L'activation s'effectue par un clic sur le bouton « Page de métrologie » dans |
||
287 | la barre de sélection d'un hôte, cerclé de rouge sur l'illustration qui suit. |
||
288 | L'intitulé de l'info-bulle d'aide est |
||
289 | « Affiche une page contenant tous les graphes de l'hôte sélectionné ». |
||
290 | Cette visualisation n'est possible qu'après renseignement de l'hôte. |
||
291 | |||
292 | .. :: @FIXME: où est l'illustration ??? |
||
293 | |||
294 | Illustration ???: Bouton de consultation de la page de métrologie associée à un hôte |
||
295 | |||
296 | |||
297 | L'affichage s'effectue dans une page distincte. Un exemple de ce type de page est donné par l'illustration . |
||
298 | |||
299 | .. figure:: img/metrology_page.png |
||
300 | |||
301 | Vue synthétique de tous les graphes d'un hôte. |
||
302 | |||
303 | |||
304 | |||
305 | Impression d'un graphe |
||
306 | ====================== |
||
307 | Cette fonctionnalité permet d'imprimer le graphe courant tel qu'il est présenté à l'écran. |
||
308 | L'activation de l'impression s'effectue par un clic dans la fenêtre du graphe sur le bouton |
||
309 | .. image:: img/100002010000001000000010DAA1BEF7.png |
||
310 | |||
311 | , cerclé de rouge sur l'illustration suivante. L'intitulé de l'info-bulle d'aide est « Imprimer le graphe ». |
||
312 | |||
313 | |||
314 | Illustration : Bouton d'impression d'un graphe |
||
315 | |||
316 | |||
317 | |||
318 | Une fenêtre d'impression s'affiche alors. |
||
319 | |||
320 | .. figure:: img/print_dialog.png |
||
321 | |||
322 | Fenêtre d'impression d'un graphe. |
||
323 | |||
324 | |||
325 | Après renseignement des paramètres d'impression et validation, cette fenêtre se referme et l'impression commence. |
||
326 | |||
327 | Export d'un graphe |
||
328 | ================== |
||
329 | Cette fonctionnalité permet d'exporter le graphe courant. |
||
330 | L'activation de l'export s'effectue par un clic dans la fenêtre du graphe sur le bouton « |
||
331 | .. image:: img/1000020100000010000000103A35F438.png |
||
332 | |||
333 | Export CSV » entouré sur l'illustration suivante (l'intitulé de l'info-bulle d'aide est « Export CSV »). |
||
334 | Illustration : Bouton d'export d'un graphe |
||
335 | |||
336 | |||
337 | Une liste semblable à celle affichée sur l'illustration (page ) s'affiche. Cette liste est composée des indicateurs du graphe et d'un indicateur général intitulé « Tous » permettant d'exporter simultanément tous les indicateurs du graphe. |
||
338 | Illustration : Liste des indicateurs exportables d'un graphe |
||
339 | |||
340 | |||
341 | Le choix de l'un de ces indicateurs permet l'export du graphe : |
||
342 | |||
343 | - avec les valeurs de l'ensemble des indicateurs dans le cas où « Tous » est sélectionné ; |
||
344 | - avec les valeurs de l'indicateur sélectionné dans les autres cas. |
||
345 | |||
346 | Après sélection d'un indicateur dans cette liste, une fenêtre d'export s'affiche, comme sur l'illustration . |
||
347 | |||
348 | .. figure:: img/export_dialog.png |
||
349 | |||
350 | Fenêtre de sauvegarde des données exportées. |
||
351 | |||
352 | |||
353 | 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 (illustration ) : |
||
354 | |||
355 | .. figure:: img/oocalc.png |
||
356 | |||
357 | Données exportées vues dans un tableur. |
||
358 | |||
359 | |||
360 | La colonne « Timestamp » correspond à un horodatage UNIX (temps écoulé depuis le 1er Janvier 1970). |
||
361 | Les données sont triées par horodatage croissant dans le fichier exporté. |
||
362 | |||
363 | Rafraîchissement automatique d'un graphe |
||
364 | ======================================== |
||
365 | Cette fonctionnalité permet de réactualiser un graphe périodiquement. |
||
366 | 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. |
||
367 | L'activation s'effectue par un clic sur le bouton |
||
368 | .. image:: img/100002010000001000000010D83BE303.png |
||
369 | |||
370 | de la fenêtre du graphe, cerclé de rouge sur l'illustration suivante. L'intitulé de l'info-bulle d'aide est « Rafraîchissement automatique du graphe ». Le bouton apparaît alors enfoncé. |
||
371 | Illustration : Bouton d'activation/désactivation du rafraîchissement automatique |
||
372 | |||
373 | |||
374 | La désactivation s'effectue aussi par un clic sur le même bouton. Le bouton apparaît alors relâché. |
||
375 | L'illustration présente l'état du bouton selon que le rafraîchissement automatique est activé ou non. |
||
376 | |||
377 | .. image:: img/10000000000000380000001C8A0A3164.png |
||
378 | |||
379 | Illustration : Rafraîchissement automatique activé (à gauche) et désactivé (à droite) |
||
380 | |||
381 | |||
382 | Un bouton global |
||
383 | .. image:: img/autorefresh.png |
||
384 | |||
385 | 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é). |
||
386 | |||
387 | Impression de l'ensemble des graphes |
||
388 | ==================================== |
||
389 | Cette fonctionnalité permet l'impression de tous les graphes affichés à l'écran. |
||
390 | L'activation s'effectue par un clic sur le bouton |
||
391 | .. image:: img/100002010000001000000010DAA1BEF7.png |
||
392 | |||
393 | situé en haut à droite de l'interface de VigiGraph, tel qu'entouré sur l'illustration qui suit. L'intitulé de l'info-bulle d'aide est « Imprimer tous les graphes affichés ». |
||
394 | Illustration : Bouton d'impression de l'ensemble des graphes affichés |
||
395 | |||
396 | |||
397 | Une fenêtre d'impression s'affiche alors, comme sur l'illustration . |
||
398 | |||
399 | .. figure:: img/print_dialog.png |
||
400 | |||
401 | Fenêtre de configuration de l'impression. |
||
402 | |||
403 | |||
404 | Après renseignement des paramètres d'impression et validation, cette fenêtre se referme et l'impression s'effectue. |
||
405 | |||
406 | Sauvegarde de l'affichage |
||
407 | ========================= |
||
408 | Cette fonctionnalité permet de sauvegarder un ensemble de graphes affichés à l'écran pour des opérations ultérieures. |
||
409 | La constitution de la sélection s'effectue via le navigateur, en ajoutant un marque-page, à l'aide des étapes suivantes : |
||
410 | |||
411 | - Cliquer sur le menu « Marque-Pages ». |
||
412 | - Choisir l'option « Marquer cette page » |
||
413 | - Saisir un nom pour le marque-page (ou laisser la valeur par défaut). |
||
414 | - Choisir le dossier « Barre personnelle » comme dossier de destination. |
||
415 | - Valider par un clic sur le bouton « Terminer ». |
||
416 | |||
417 | Le rappel de la sélection s'effectue également via le navigateur, en utilisant la procédure suivante : |
||
418 | |||
419 | - Cliquer sur le menu « Marque-Pages ». |
||
420 | - Choisir l'option « Marqués récemment ». |
||
421 | - Sélectionner l'élément créé à l'étape 3 lors de l'ajout du marque-page . |
||
422 | - Valider à l'aide du bouton F5. |
||
423 | |||
424 | |||
425 | Moteur de recherche |
||
426 | =================== |
||
427 | La phase de recherche nécessite au préalable l'enregistrement du moteur de recherche de VigiGraph au sein du navigateur. Cette déclaration ne doit être effectuée qu'une seule fois. |
||
428 | Pour enregistrer le moteur de recherche : |
||
429 | |||
430 | - Cliquer sur le bouton à gauche de la zone des moteurs de recherche (cerclé de rouge sur l'illustration ). |
||
431 | → La liste des moteurs actuellement enregistrés s'affiche, ainsi que des actions possibles. |
||
432 | - Cliquer sur la ligne « Ajouter "Recherche Vigilo" ». |
||
433 | → Le moteur de recherche de VigiGraph est ajouté à la liste des moteurs de recherche disponibles et la liste disparaît de l'écran. |
||
434 | |||
435 | Une fois le moteur de recherche enregistré, il apparaît dans le navigateur sous la forme d'une zone de saisie, comme sur l'illustration . |
||
436 | Illustration : Moteur de recherche enregistré |
||
437 | |||
438 | |||
439 | Pour effectuer une recherche : |
||
440 | |||
441 | - 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. |
||
442 | - Saisir un intitulé dans la zone de saisie. |
||
443 | - Cliquer sur le bouton en forme de loupe à droite ou valider à l'aide de la touche « Entrée ». |
||
444 | |||
445 | → Une page présentant des informations sur les serveurs répondant à la requête s'affiche alors. |
||
446 | |||
447 | Un exemple de résultats obtenus lors de la recherche du terme « local » est présenté sur l'illustration suivante. |
||
448 | |||
449 | .. figure:: img/opensearch_results.png |
||
450 | |||
451 | Résultat de l'utilisation du moteur de recherche. |
||
452 | |||
453 | |||
454 | Dans cette page, sur chaque ligne, figurent : |
||
455 | |||
456 | - le nom de l'équipement ; |
||
457 | - un lien vers la page de supervision (voir ) ; |
||
458 | - un lien vers la métrologie de l'hôte, c'est-à-dire la liste de ses graphes (voir ). |
||
459 | |||
460 | Un clic sur l'un de ces liens remplace la page courante par la page demandée. |
||
461 | Le lien intitulé « Page de métrologie » permet de consulter l'ensemble des graphes de l'hôte concerné. Le lien intitulé « Page de supervision » donne accès à la page de supervision de l'hôte concerné dans Nagios. |
||
462 | |||
463 | Description de l'interface |
||
464 | ########################## |
||
465 | |||
466 | Architecture statique d'un écran |
||
467 | ================================ |
||
468 | Un écran comporte : |
||
469 | |||
470 | - une barre de titre |
||
471 | - une zone d'affichage |
||
472 | - des zones de saisie éventuelles |
||
473 | - un ensemble de boutons |
||
474 | |||
475 | |||
476 | Dynamique des écrans |
||
477 | ==================== |
||
478 | On distingue deux types d'écran: |
||
479 | |||
480 | - page : ressource web (associée à une URL) |
||
481 | - fenêtre : ressource graphique |
||
482 | |||
483 | L'activation d'une URL dans le navigateur, d'un lien dans une page ou d'un bouton dans une fenêtre provoque l'affichage de l'écran associé. |
||
484 | Le positionnement de la souris sur un bouton provoque l'affichage de l'intitulé d'aide associé (s'il y a lieu). |
||
485 | |||
486 | Écrans |
||
487 | ====== |
||
488 | |||
489 | Formulaire d'authentification |
||
490 | ----------------------------- |
||
491 | Ce formulaire permet la saisie des informations d'authentification. |
||
492 | Il s'affiche au lancement. |
||
493 | |||
494 | .. figure:: img/login_form.png |
||
495 | |||
496 | |||
497 | |||
498 | Page VigiGraph |
||
499 | -------------- |
||
500 | Cette page autorise les opérations de visualisation (graphes et pages), d'impression (graphes) et de recherche (hôtes et graphes). |
||
501 | Elle s'affiche une fois l'authentification effectuée. |
||
502 | |||
503 | .. figure:: img/homepage.png |
||
504 | |||
505 | |||
506 | La visualisation s'effectue via la barre de sélection d'un hôte / graphe. |
||
507 | |||
508 | Barre de sélection d'un hôte / graphe |
||
509 | ------------------------------------- |
||
510 | Cette barre se présente comme suit : |
||
511 | |||
512 | .. figure:: img/selection_bar.png |
||
513 | |||
514 | |||
515 | Dans cette barre, les champs suivis d'une flèche pointant vers le bas permettent de sélectionner une valeur (un hôte ou un graphe, selon le bouton cliqué), tandis que le bouton « Page Nagios » et « Page de métrologie » permettent d'afficher respectivement la page Nagios et la page de métrologie de l'hôte sélectionné. |
||
516 | Une fois l'hôte sélectionné, les boutons d'affichage de la page Nagios, de la page de métrologie et de sélection du graphe s'activent. Une fois le nom du graphe à afficher sélectionné, celui-ci apparaît à l'écran. |
||
517 | |||
518 | Graphe |
||
519 | ------ |
||
520 | Cette fenêtre permet la visualisation d'un graphe. |
||
521 | |||
522 | .. figure:: img/graph_window.png |
||
523 | |||
524 | |||
525 | Cette fenêtre comporte : |
||
526 | |||
527 | - une barre de titre rappelant le nom de l'hôte et du graphe affiché ; |
||
528 | - un bouton système permettant de fermer la fenêtre |
||
529 | .. image:: img/100000000000001000000010D02CC003.png |
||
530 | |||
531 | ; |
||
532 | - des boutons de gestion de l'affichage du graphe ; |
||
533 | - la zone d'affichage du graphe. |
||
534 | |||
535 | |||
536 | |||
537 | ================ ================ ======================================================================= |
||
538 | Bouton Intitulé de la Détail |
||
539 | bulle d'aide |
||
540 | |img2| Recharger le Rafraîchissement automatique du graphe selon la période déclarée dans |
||
541 | graphe le fichier de configuration : |
||
542 | - enfoncé → rafraîchissement automatique |
||
543 | - relâché → pas de rafraîchissement |
||
544 | |img3| Menu de choix de Liste des plages de temps |
||
545 | Période la période Après sélection, rafraîchissement du graphe |
||
546 | |img4| Début du graphe Rafraîchissement du graphe avec les valeurs de la première plage de |
||
547 | temps |
||
548 | |img5| Section Rafraîchissement du graphe avec les valeurs de la plage de temps |
||
549 | précédente précédente |
||
550 | |img6| Section suivante Rafraîchissement du graphe avec les valeurs de la plage de temps |
||
551 | suivante |
||
552 | |img7| Fin du graphe Rafraîchissement du graphe avec les valeurs de la dernière plage de |
||
553 | temps |
||
554 | |img8| Zoomer Rafraîchissement du graphe avec agrandissement de la plage de temps (x |
||
555 | 2) |
||
556 | |img9| Dézoomer Rafraîchissement du graphe avec diminution de la plage de temps (/ 2) |
||
557 | |img10| Export CSV Export du graphe (voir §). |
||
558 | Export CSV |
||
559 | |img11| Imprimer le Impression du graphe (voir §). |
||
560 | graphe |
||
561 | ================ ================ ======================================================================= |
||
562 | |||
563 | |||
564 | |||
565 | .. |img2| image:: img/100002010000001000000010119669AF.png |
||
566 | |||
567 | .. |img3| image:: img/1000020100000010000000109787A6BD.png |
||
568 | |||
569 | .. |img4| image:: img/100002010000001000000010301CF203.png |
||
570 | |||
571 | .. |img5| image:: img/100002010000001000000010CB569423.png |
||
572 | |||
573 | .. |img6| image:: img/1000020100000010000000107ABC8922.png |
||
574 | |||
575 | .. |img7| image:: img/10000201000000100000001018DF7CB8.png |
||
576 | |||
577 | .. |img8| image:: img/1000020100000010000000106B00FCEC.png |
||
578 | |||
579 | .. |img9| image:: img/100002010000001000000010042272EB.png |
||
580 | |||
581 | .. |img10| image:: img/1000020100000010000000103A35F438.png |
||
582 | |||
583 | .. |img11| image:: img/100002010000001000000010DAA1BEF7.png |
||
584 | |||
585 | La fermeture de cette fenêtre s'effectue par un clic sur le bouton système |
||
586 | .. image:: img/100000000000001000000010D02CC003.png |
||
587 | |||
588 | . |
||
589 | |||
590 | Page de supervision |
||
591 | ------------------- |
||
592 | Cette page permet la visualisation des données Nagios pour un hôte. |
||
593 | |||
594 | .. figure:: img/nagios_page.png |
||
595 | |||
596 | |||
597 | |||
598 | Impression |
||
599 | ---------- |
||
600 | Cette fenêtre est destinée à saisir les paramètres d'impression. Elle s'affiche après déclenchement d'une demande d'impression. |
||
601 | |||
602 | .. figure:: img/print_dialog.png |
||
603 | |||
604 | |||
605 | |||
606 | Export CSV |
||
607 | ---------- |
||
608 | Cette fenêtre est destinée à saisir les paramètres d'export. |
||
609 | Elle s'affiche après activation d'un export. |
||
610 | |||
611 | .. figure:: img/export_dialog.png |
||
612 | |||
613 | |||
614 | Dans la barre de titre, figure le nom du fichier généré, composé de la manière suivante : « <intitulé_hôte> - <intitulé_graphe> (<plage de temps>).csv » |
||
615 | Le détail figure dans le tableau ci-dessous : |
||
616 | |||
617 | ================= ================= ================================================================= |
||
618 | Champ Correspondance Détail |
||
619 | <intitulé_hôte> Nom du serveur |
||
620 | <intitulé_graphe> Nom du graphe ou |
||
621 | de l'indicateur |
||
622 | sélectionné |
||
623 | <plage_temps> Texte de la forme Pour chaque date, le format suivant est utilisé : |
||
624 | |date_fmt| |date_fmt_details| |
||
625 | avec : |
||
626 | <Année> : 4 caractères |
||
627 | autres éléments : deux caractères |
||
628 | ================= ================= ================================================================= |
||
629 | |||
630 | .. |date_fmt| replace:: <date début> - <date_fin> |
||
631 | .. |date_fmt_details| replace:: <Année>_<Mois>_<Jour>-<Heure>:<Minutes>:<Secondes> |
||
632 | |||
633 | |||
634 | Recherche |
||
635 | --------- |
||
636 | Cette fenêtre permet l'affichage de la liste des couples Hôtes-Graphes. |
||
637 | Elle se présente comme suit : |
||
638 | |||
639 | .. figure:: img/search_form_empty.png |
||
640 | |||
641 | |||
642 | Cette fenêtre comporte : |
||
643 | |||
644 | - une barre de titre |
||
645 | - deux zones de saisie et un bouton pour déclencher la recherche |
||
646 | - une zone d'affichage des résultats |
||
647 | |||
648 | Le détail figure dans le tableau ci-dessous : |
||
649 | |||
650 | ============================ ================================================================ |
||
651 | Contrôle de la fenêtre de Détail |
||
652 | sélection d'hôte / |
||
653 | indicateur |
||
654 | Bouton « Rechercher » Un clic déclenche la recherche et l'affichage des hôtes/graphes |
||
655 | du parc correspondant aux critères de recherche saisis. |
||
656 | Zone de saisie « Hôte » Seuls les hôtes dont le nom correspond au motif saisi dans cette |
||
657 | zone seront affichés dans les résultats de la recherche. |
||
658 | Zone de saisie « Graphe » Seuls les graphes dont le nom correspond au motif saisi dans |
||
659 | cette zone seront affichés dans les résultats de la recherche. |
||
660 | ============================ ================================================================ |
||
661 | |||
662 | |||
663 | Si seule la zone de saisie « Hôte » a été renseignée, alors les résultats de la recherche ne contiendront que la liste des noms d'hôtes correspondant. Si la zone de saisie « Graphe » a été renseignée, les résultats de la recherche contiendront le nom de chaque graphe correspondant au motif saisi et le nom de l'hôte auquel ce graphe est associé. |
||
664 | Un clic dans la zone d'affichage des résultats sur le nom d'un graphe déclenche l'ouverture de ce graphe. Un clic sur le nom d'un hôte pré-sélectionne cet hôte dans la barre de sélection. |
||
665 | |||
666 | Format des sorties |
||
667 | ################## |
||
668 | VigiGraph permet des sorties : |
||
669 | |||
670 | - écran : affichage des graphes et des pages de supervision |
||
671 | - papier : impression des graphes |
||
672 | - fichier : export CSV d'un graphe |
||
673 | |||
674 | |||
675 | La sortie par défaut d'un fichier au format CSV se caractérise comme suit : |
||
676 | |||
677 | - Les valeurs sont entourées par des guillemets droits (") et séparées par des points virgules (;). |
||
678 | - Le contre-oblique (\) est utilisé en tant que caractère d'échappement. |
||
679 | - 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). |
||
680 | - Les lignes suivantes correspondent aux valeurs de chaque indicateur à l'instant identifié par la valeur de la colonne « Timestamp ». |
||
681 | - Les lignes sont triées par ordre chronologique croissant. |
||
682 | |||
683 | 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. |
||
684 | |||
685 | |||
686 | Annexes |
||
687 | ####### |
||
688 | |||
689 | .. include:: ../../turbogears/doc/glossaire.rst |
||
690 | |||
691 | Liste des URL |
||
692 | ------------- |
||
693 | |||
694 | Le tableau suivant recense les URL disponibles dans VigiGraph. |
||
695 | Les paramètres obligatoires de l'URL sont indiqués en gras (dans la colonne du milieu). |
||
696 | |||
697 | ================ ======================== ======================================================== |
||
698 | Fonctionnalité URL Détail |
||
699 | Interface <prefix_url>/ L'interface principale d'accès à VigiGraph s'affiche. |
||
700 | principale. |
||
701 | Recherche d'un <prefixe_url>/rpc/search VigiGraph affiche l'ensemble des hôtes dont le nom |
||
702 | hôte ou d'un Host?**query**=<intitulé contient <intitulé_query>, sans distinction |
||
703 | ensemble _query> majuscules/minuscules. |
||
704 | d'hôtes. |
||
705 | Image d'un <prefixe_url>/rpc/getIma Paramètres : |
||
706 | graphe au format ge_png?**host**=<intitul |
||
707 | PNG. é_host>&**graph**=<intit - <intitulé_host> = serveur cible |
||
708 | ulé_graph>&start=<intitu - <intitulé_graph> = graphe |
||
709 | lé_start>&duration=<inti - <intitulé_start> = date-heure de début du graphe |
||
710 | tulé_duration> - <intitulé_duration> = durée du graphe |
||
711 | Export CSV. <prefixe_url>/rpc/export Paramètres : |
||
712 | CSV?**host**=<intitulé_h |
||
713 | ost>&**indicator**=<inti - <intitulé_host> = serveur cible |
||
714 | tulé_indicator> - <intitulé_indicator> = indicateur associé à un graphe |
||
715 | |||
716 | |||
717 | Particularités : |
||
718 | * Pour un export sur l'ensemble des indicateurs, |
||
719 | <intitulé_indicator> est renseigné avec la chaîne « all |
||
720 | ». |
||
721 | |||
722 | Exemple : |
||
723 | localhost:8082/rpc/exportCSV?host=par.linux0&indicator=I |
||
724 | O%20Reads |
||
725 | ================ ======================== ======================================================== |
||
726 | |||
727 | Les intitulés du type ``...`` permettent le paramétrage de l'URL. |
||
728 | Ils sont de type chaîne de caractères. |
||
729 | |||
730 | |||
731 | .. vim: set tw=79 : |