Information sur les CGI


Introduction

Voici une brève description des CGI fournis avec Nagios, ainsi que des autorisations requises pour accèder et utiliser ces CGI.

Important : Par défaut, les CGI ne fonctionnent que si vous vous êtes authentifié auprès du serveur web et que vous êtes autorisé à accéder aux informations demandées. Pour plus d'informations sur la configuration des autorisations de votre serveur web et des CGI, lisez les sections Installer l'interface web et Authentification et autorisations dans les CGI.

Index

CGI d'état
CGI de cartographie des états
CGI d'interface WAP
CGI du monde des états (VRML)
CGI d'aperçu tactique
CGI d'indisponibilité du réseau
CGI de configuration
CGI de commande
CGI d'informations complémentaires
CGI du fichier journal
CGI d'historique d'alerte
CGI des notifications
CGI des tendances
CGI de rapport de disponibilité
CGI des histogrammes des alertes
CGI de récapitulatif des alertes

CGI d'état
   
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). Vous pouvez associer de jolies icônes aux hôtes en utilisant les options d'informations complémentaires sur les hôtes du fichier de configuration.

Autorisation requises :

 

CGI de cartographie des états
Status Map CGI
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 retirées des options d'informations complémentaires sur les hôtes du fichier de configuration. Si vous ne pouvez pas accéder à ce CGI, ou si vous avez des erreurs lors de sa compilation ou de son exécution, lisez cette FAQ.

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.

Note : Les utilisateurs qui ne sont pas autorisés à voir un hôte particulier verront un noeud 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
WAP Interface CGI
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)
3-D Status Map CGI
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 définies en utilisant les options d'informations complémentaires sur les hôtes du fichier de configuration des CGI. Il vous faudra un navigateur incluant le composant VRML (comme Cortona) 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.

Note : Les utilisateurs qui ne sont pas autorisés à voir un hôte particulier verront un noeud 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
Tactical Overview CGI
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 (i.e. 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
Network Outages CGI
Nom du fichier : outages.cgi

Description :
Ce CGI produit une liste des hôtes "à problèmes" de votre réseau qui sont responsables des 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. Pour plus d'informations sur le fonctionnement de ce CGI, voyez ici.

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
Configuration CGI - Hosts
Nom du fichier : config.cgi

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

Autorisations requises :

 

CGI de commande
Command CGI
Nom du fichier : cmd.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 CGI comme point de départ pour envoyer des commandes.

Autorisations requises :

Notes :

  • Si vous avez choisi de ne pas utiliser l'authentification dans les CGI, ce CGI ne permettra à personne d'envoyer des commandes à Nagios, et ce dans votre propre intérêt. Je suggère de plus dans ce cas de supprimer le CGI.
  • Pour que ce CGI envoie effectivement ses commandes à Nagios, vous devrez mettre les bons droits d'accès aux fichiers et aux répertoires ainsi que le décrit cette FAQ.

CGI d'informations complémentaires
Extended Information CGI - Process Information Extended Information CGI - Network Health Extended Information CGI - Host Information Extended Information CGI - Service Information  
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 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
Log File CGI
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
History CGI
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
Notifications CGI
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 relatives à tous les hôtes et tous les services.
  • Si vous êtes autorisé pour tous les services vous pouvez voir les notifications relatives à 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
Trends CGI
Nom du fichier : trends.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. Si vous ne pouvez pas accéder à ce CGI, ou si vous avez des erreurs lors de sa compilation ou de son exécution, lisez cette FAQ.

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é
 
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
Alert Histogram CGI
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. Si vous ne pouvez pas accéder à ce CGI, ou si vous avez des erreurs lors de sa compilation ou de son exécution, lisez cette FAQ.

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 du récapitulatif des alertes
Alert Summary CGI
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 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.