Chapitre 36. Informations sur les CGIs

Introduction

Vous trouverez ici une description de l'ensemble des CGIs de Nagios ainsi que les autorisations nécessaires pour accéder à chacun d'eux. Par défaut, les CGIs ne fonctionnent que si vous vous êtes authentifiés auprès du serveur web et que vous êtes autorisés à accéder aux informations demandées. Pour plus d'informations sur la configuration des autorisations de votre serveur web et des CGIs, lisez les sections Installer l'interface web et Authentification et autorisations dans les CGIs.

CGI d'état

CGI Status a
CGI Status b
CGI Status c
CGI Status d
Nom du fichier

status.cgi

Description

C'est le CGI le plus important de Nagios. Il vous permet de voir l'état de tous les hôtes et de tous les services supervisés. Le CGI d'état peut produire deux types principaux d'affichage - un aperçu de l'état de tous les groupes d'hôtes (ou d'un groupe particulier) et une vue détaillée de tous les services (ou de ceux associés à un hôte particulier).

Autorisations requises

CGI de cartographie des états

CGI Status Map
Nom du fichier

statusmap.cgi

Description

Ce CGI crée une carte de tous les hôtes que vous avez défini dans votre réseau. Il utilise la bibliothèque GD de Thomas Boutell (version 1.6.3 ou plus) pour créer une image au format PNG de l'agencement de votre réseau. Les coordonnées utilisées pour dessiner chaque hôte (ainsi que les jolies icônes facultatives) sont extraites des définitions d' hôtes. Si vous souhaitez plutôt laisser le CGI dessiner automatiquement les coordonnées pour vous, utilisez le paramètre default_statusmap_layout pour spécifier l'algorithme à utiliser.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir tous les hôtes.

  • Si vous êtes un contact authentifié vous pouvez voir les hôtes dont vous êtes un contact.

Les utilisateurs qui ne sont pas autorisés à voir un hôte particulier verront un nœud nommé unknown à la place. Je suis conscient qu'ils ne devraient rien voir du tout, mais ça n'a aucun sens de générer la carte si vous ne pouvez pas voir les dépendances entre les hôtes…

CGI d'interface WAP

CGI Status WML
Nom du fichier

statuswml.cgi

Description

Ce CGI gère l'interface WAP d'accès aux informations sur l'état du réseau. Si vous avez un appareil WAP (i.e. un téléphone portable compatible Internet), vous pouvez accéder aux informations d'état alors que vous êtes en déplacement. Les vues disponibles comprennent le résumé par groupe d'hôtes, l'aperçu par groupe d'hôtes, le détail d'un hôte, le détail d'un service, tous les problèmes, et les problèmes non pris en compte. Vous pouvez de plus désactiver les notifications et les contrôles et acquitter des problèmes depuis votre portable. Plutôt cool, non ?

Autorisations requises

CGI du monde des états (VRML)

CGI Status WRL
Nom du fichier

statuswrl.cgi

Description

Ce CGI crée une modélisation en 3D utilisant le langage VRML de tous les hôtes définis dans votre réseau. Les coordonnées utilisées pour dessiner les hôtes (ainsi que les jolies textures) sont extraites des définitions d'hôtes. Si vous souhaitez plutôt laisser le CGI dessiner automatiquement les coordonnées pour vous, utilisez le paramètre default_statusmap_layout pour spécifier l'algorithme à utiliser. Il vous faudra un navigateur VRML (comme Cortona, Cosmo Player ou WorldView) installé sur votre système pour pouvoir visualiser ce modèle.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir tous les hôtes.

  • Si vous êtes un contact authentifié vous pouvez voir les hôtes dont vous êtes un contact.

Les utilisateurs qui ne sont pas autorisés à voir un hôte particulier verront un nœud nommé unknown à la place. Je suis conscient qu'ils ne devraient rien voir du tout, mais ça n'a aucun sens de générer la carte si vous ne pouvez pas voir les dépendances entre les hôtes…

CGI d'aperçu tactique

CGI Tac
Nom du fichier

tac.cgi

Description

Ce CGI vous donne une vue générale de toute l'activité de supervision du réseau. Il vous permet de repérer rapidement les indisponibilités du réseau, l'état des hôtes et des services. Il distingue les problèmes qui ont été traités d'une façon ou d'une autre (par ex. qui ont été acquittés, dont les notifications sont désactivées, etc.) et ceux qui n'ont pas été traités, et qui donc méritent attention. Très utile si vous avez beaucoup d'hôtes/services à superviser et que vous ne voulez consulter qu'un seul écran pour être averti des problèmes.

Autorisations requises

CGI d'indisponibilité du réseau

CGI Outages
Nom du fichier

outages.cgi

Description

Description : Ce CGI produit une liste des hôtes à problèmes de votre réseau qui sont responsables de ruptures de lien. Ceci est particulièrement utile sur les grands réseaux pour identifier rapidement la cause d'un problème. Les hôtes sont triés selon la gravité de la rupture dont ils sont responsables.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir tous les hôtes.

  • Si vous êtes un contact authentifié vous pouvez voir les hôtes dont vous êtes un contact.

CGI de configuration

CGI Config
Nom du fichier

config.cgi

Description

Ce CGI permet de visualiser les définitions d'objets (par ex. hôtes, groupes d'hôtes, contacts, groupes de contacts, périodes, services et commandes) tels que spécifiés dans vos fichier(s) de configuration des objets.

Autorisations requises

CGI de commande

CGI Commands
Nom du fichier

scmd.cgi

Description

Ce CGI permet d'envoyer des commandes au processus de Nagios. Bien que ce CGI accepte plusieurs arguments, mieux vaut ne pas s'y essayer. La plupart changent selon les révisions de Nagios. Utilisez plutôt les informations complémentaires des CGIs comme point de départ pour envoyer des commandes.

Autorisations requises

Si vous avez choisi de ne pas utiliser l'authentification dans les CGIs, ce CGI ne permettra à personne d'envoyer des commandes à Nagios, et ce dans votre propre intérêt. Je suggère dans ce cas de supprimer le CGI.

CGI d'informations complémentaires

CGI Extinfo a
CGI Extinfo b
CGI Extinfo c
CGI Extinfo d
Nom du fichier

extinfo.cgi

Description

Ce CGI permet de voir les informations relatives au processus de Nagios, aux statistiques sur les hôtes et les services, aux commentaires sur les hôtes et les services, et plus encore. C'est également un point d'entrée pour envoyer des commandes à Nagios via le CGI de commande. Bien que ce CGI accepte plusieurs arguments, mieux vaut ne pas s'y essayer : la plupart changent selon les révisions de Nagios. Vous pouvez accéder à ce CGI en cliquant sur les liens appelés 'Network Health' [NdT: Santé/Etat du réseau] et 'Process Information' [NdT: Information sur le processus Nagios] de la barre latérale de navigation, ou en cliquant sur un lien hôte ou service dans l'affichage du CGI d'état.

Autorisations requises
  • Vous devez être autorisé pour les informations système pour voir les informations sur le processus de Nagios.

  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir les informations complémentaires de tous les hôtes et de tous les services.

  • Si vous êtes autorisé pour tous les services vous pouvez voir les informations complémentaires de tous les services.

  • Si vous êtes un contact authentifié vous pouvez voir les informations complémentaires de tous les hôtes et de tous les services dont vous êtes un contact.

CGI du fichier journal

CGI Showlog
Nom du fichier

showlog.cgi

Description

Ce CGI affiche le fichier journal. Si vous avez activé la rotation du journal, vous pouvez voir le contenu des journaux archivés en utilisant les liens de navigation situés en haut de la page.

Autorisations requises

CGI d'historique d'alerte

CGI History
Nom du fichier

history.cgi

Description

Ce CGI affiche l'historique des problèmes relatifs soit à un hôte particulier soit à tous les hôtes. L'affichage est un sous-ensemble de ce que produit le CGI du fichier journal. Vous pouvez filtrer l'affichage pour n'obtenir que certains types de problèmes (i.e. alertes hard et/ou soft, les différents types d'alertes sur les services et les hôtes, tous les types d'alertes, etc.). Si vous avez activé la rotation du journal, vous pouvez voir l'historique contenu dans les journaux archivés en utilisant les liens de navigation situés en haut de la page.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir l'historique de tous les hôtes et de tous les services.

  • Si vous êtes autorisé pour tous les services vous pouvez voir l'historique de tous les services.

  • Si vous êtes un contact authentifié vous pouvez voir l'historique de tous les hôtes et tous les services dont vous êtes un contact.

CGI des notifications

CGI Notifications
Nom du fichier

notifications.cgi

Description

Ce CGI affiche les notifications envoyées aux différents contacts d'un hôte ou d'un service. L'affichage est un sous-ensemble de ce que produit le CGI du fichier journal. Vous pouvez filtrer l'affichage pour n'obtenir que certains types de problèmes (i.e. notifications relatives aux services, aux hôtes, envoyées à des contacts spécifiques, etc). Si vous avez activé la rotation du journal, vous pouvez voir les notifications contenues dans les journaux archivés en utilisant les liens de navigation situés en haut de la page.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir les notifications de tous les hôtes et tous les services.

  • Si vous êtes autorisé pour tous les services vous pouvez voir les notifications de tous les services.

  • Si vous êtes un contact authentifié vous pouvez voir les notifications relatives à tous les hôtes et tous les services dont vous êtes un contact.

CGI de tendances

CGI Trends
Nom du fichier

strends.cgi

Description

Ce CGI crée un graphique des états des hôtes et des services sur une période donnée. Pour que ce CGI soit pertinent, vous devez activer la rotation du journal et archiver les journaux dans le répertoire défini par la variable log_archive_path . Ce CGI utilise la bibliothèque gd de Thomas Boutell (version 1.6.3 ou plus) pour créer l'image des tendances.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir les tendances de tous les hôtes et de tous les services.

  • Si vous êtes autorisé pour tous les services vous pouvez voir les tendances de tous les services.

  • Si vous êtes un contact authentifié vous pouvez voir les tendances de tous les hôtes et tous les services dont vous êtes un contact.

CGI de rapport de disponibilité

CGI Availability a
CGI Availability b
Nom du fichier

avail.cgi

Description

Ce CGI permet de créer un rapport sur la disponibilité des hôtes et des services sur une période donnée. Pour que ce CGI soit pertinent, vous devez activer la rotation du journal et archiver les journaux dans le répertoire défini par la variable log_archive_path .

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir la disponibilité de tous les hôtes et services.

  • Si vous êtes autorisé pour tous les services vous pouvez voir la disponibilité de tous les services.

  • Si vous êtes un contact authentifié vous pouvez voir la disponibilité de tous les services et hôtes dont vous êtes un contact.

CGI d'histogramme des alertes

CGI Histogram
Nom du fichier

histogram.cgi

Description

Ce CGI permet d'afficher l'histogramme de disponibilité d'hôtes et services sur une période de temps. Pour que ce CGI soit pertinent, vous devez activer la rotation du journal et archiver les journaux dans le répertoire défini par la variable log_archive_path . Ce CGI utilise la bibliothèque GD de Thomas Boutell (version 1.6.3 ou plus) pour créer l'image des tendances.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir les histogrammes de tous les hôtes et services.

  • Si vous êtes autorisé pour tous les services vous pouvez voir les histogrammes de tous les services.

  • Si vous êtes un contact authentifié vous pouvez voir les histogrammes de tous les services et hôtes dont vous êtes un contact.

CGI du récapitulatif des alertes

CGI Summary
Nom du fichier

summary.cgi

Description

Ce CGI fournit des rapports synthétiques sur les alertes concernant les hôtes et services, ainsi que le nombre total d'alertes, les services/hôtes générant le plus d'alertes, etc.

Autorisations requises
  • Si vous êtes autorisé pour tous les hôtes vous pouvez voir le récapitulatif de tous les hôtes et services.

  • Si vous êtes autorisé pour tous les services vous pouvez voir le récapitulatif de tous les services.

  • Si vous êtes un contact authentifié vous pouvez voir le récapitulatif de tous les services et hôtes dont vous êtes un contact.