Important: Nagios peut être configuré avec différentes méthodes, en ce qui concerne le stockage des informations complémentaires. Cette documentation décrit comment configurer ces données si vous avez compilé Nagios pour supporter l'ancien format des informations complémentaires. (c.a.d avec l'option --with-default-extinfo du script configure). Notez, svp, que ce format est fourni uniquement pour des raisons de compatibilité avec les anciennes versions. Il n'offre ni la flexibilité, ni la lisibilité des fichiers à base de modèles. Je vous suggère fortement ( et amicalement) de considérer le passage à ce type de fichier, puisqu'ils seront les standards utilisés désormais et dans le futur.
Introduction
Qaund vous utilisez ces routines par défaut, les informations complémentaires des hôtes et des services sont définis votre fichier CGI de configuration. Chaque définition doit être sur une ligne séparée, dans ce fichier.
Index
Informations complémentaires des hôtes
Informations complémenatires des services
| Informations complémentaires des hôtes |
| Format: | hostextinfo[<host_name>]=<notes_url>;<icon_image>;<vrml_image>;<gd2_image>;<alt_tag>;<x_2d>,<y_2d>;<x_3d>,<y_3d>,<z_3d> |
| Exemple: | hostextinfo[router3]=/hostinfo/router3.html;cat5000.png;cat5000.png;cat5000.gd2;Cisco Catalyst 5000;100,50;3.5,2.0,5.5 |
Les données complémentaires des hôtes sont généralement utilisées pour formater la sortie des CGIS d'état, de cartographie des états, de monde des états, et des informations complémentaires aient "une bonne tête". Ils n'affectent en rien la surveillance et sont complètement optionnels.
| <host_name> | Ceci est le nom court de l'hôte, tel que défini dans le fichier de configuration des hôtes. | |
| <notes_url> |
Ceci est une URL optionnelle qui peut être utilisée pour
fournir plus d' informations sur l'hôte. Si vous spécifiez
une URL, vous verrez un lien "Notes About This Host" dans les CGI d'informations
complémentaires (quand vous regarderez les informations à
propos de cet hôte). N'importe quel URL valide peut être
employée. Si vous désirez utiliser des chemins relatifs,
la racine sera la même que celle utilisé pour les CGIs
(c.a.d /cgi-bin/nagios/). Ceci peut être très
utile si vous voulez donner des informations détaillées
sur l'hôte, telles que les contacts en cas d'urgence,etc.. aux autres
membres des équipes de support. |
|
| <icon_image> | Le nom d'une image GIF, PNG, ou JPG qui sera associée avec cet hôte. Elle sera affichée dans les CGIs d'état et d'informations complémentaires. Pour un aspect correct, choisissez une taille de 40x40 pixels. les images des hôtes sont supposées être dans le sous-répertoire logos/ de votre répertoire images HTML (c.a.d /usr/local/nagios/share/images/logos). | |
| <vrml_image> | Le nom d'une image GIF, PNG, ou JPG qui sera associée à cet hôte.image. Cette image sera utilisé comme texture pour l'hôte spécifié, dans le CGI du monde des états. Contrairement à l'image utilisée pour la variable <icon_image> , celle-ci ne doit pas être transparente, sinon, l'objet représenté sera un peu étrange/bizarre. Les images pour ces hôtes sont supposées être dans le sous-répertoire logos/ du répertoire des images HTML (c.a.d /usr/local/nagios/share/images/logos). | |
| <gd2_image> | Le nom d'une image au format GD2 qui sera associée à cet hôte. Elle sera affichée dans l'image crée par le CGI de cartographie des états. Les images GD2 peuvent être crées en utilisant le programme pngtogd2 fournie via la librairie gd de Thomas Boutell's . Elles doivent être crées en format non compressé pour minimiser la charge CPU, quand le CGI génère l'image de la carte du réseau. Pour un aspect correct, choisissez une taille de 40x40 pixels. Vous pouvez laisser cette option vide si vous n'utilisez pas le CGI d'état. Les images sont supposées être dans le sous-répertoire logos/ du répertoire des images HTML (c.a.d /usr/local/nagios/share/images/logos). | |
| <alt_tag> | Une chaine optionnelle qui est utilisée par l'étiquette ALT de l'image spécifiée par l'argument <icon_image> . L'étiquette ALT est utilisée à la fois dans le CGI d'état et celui de la cartographie des états. | |
| <x_2d>,<y_2d> |
Les coordonnées à utiliser pour le dessin de l'hôte dans le CGI de cartographie des états. Elles doivent être des entiers positifs et correspondre aux pixels physiques de l'image générée. L'origine du dessin (0,0) est dans le coin supérieur gauche de l'écran et s'étend : 1) sur des coordonnées en x positives vers la droite en haut de l'image 2) sur des coordonnées en y positives le long du coté gauche vers le bas de l'image. Pour référence, notez que les icônes dessinées ont une taille d'environ 40x40 pixels (le texte prend un peu d'espace). Les coordonnées choisies désignent le coin supérieur gauche de l'icône de l'hôte. Note : ne vous inquiétez pas des coordonnées maximum en x et y que vous pouvez utiliser. Le CGI va calculer automatiquement les dimensions de l'image, à partir des plus grandes valeurs de x et y que vous aurez spécifiées. |
|
| <x_3d>,<y_3d>,<z_3d> |
Les coordonnées à utiliser pour les dessin d'un hôte dans le CGI du monde des états. Les coordonnées peuvent être des réels positifs ou négatifs. L'origine du dessin est (0.0,0.0,0.0). Pour référence, la taille des cubes représentant les hôtes est d'environ 0,5 unités par coté (le texte prend un peu de place). Les coordonnées que vous avez spécifiées pointent sur le centre du cube. |
| Informations complémentaires sur les services |
| Format: | serviceextinfo[<host_name>;<svc_description>]=<notes_url>;<icon_image>;<alt_tag> |
| Exemple: | serviceextinfo[router3;PING]=/serviceinfo/router3.html#PING;ping.png;PING Stats |
Les informations complémentaires sur les services sont utilisées principalement pour que l'image générée par les CGIs d'état et d'informations complémentaires "ait une bonne tête". Ils n'ont aucun effet sur la surveillance et sont complètement optionnels.
| <host_name> | Ceci est un nom court de l'hôte associé avec le service, tel qu'il est défini dans le fichier de definition des services. |
| <svc_description> | C'est la description du service, tel que défini dans le fichier de définition des services. |
| <notes_url> |
C'est une URL optionnelle qui peut être utilisée pour fournir plus d'informations sur ce service. Si vous spécifiez une URL, vous verrez un lien "Notes About This Service" dans le CGI des informations complémentaires. (quand vous regarderez les informations de ce service). N'importe quelle URL valide peut être employée. Si vous utilisez des chemins relatifs, la racine sera la même que celle utilisée pour accéder les CGIs (c.a.d /cgi-bin/nagios/). Ceci peut être très utile pour mettre à disposition des informations détaillées sur le service, sur les contacts en cas d'urgence, etc. à disposition des autres membres de l'équipe. |
| <icon_image> | Le nom d'une image GIF, PNG, ou JPG associée à ce service. Elle sera utilisée par les CGI d'état et d'informations complémentaires. Pour un aspect correct, choisissez une image de taille 40x40 pixels. Les images des hôtes sont supposées être dans le sous-répertoire logos/ du répertoire des images HTML (c.a.d /usr/local/nagios/share/images/logos). |
| <alt_tag> | Une chaîne optionnelle utilisée par l'étiquette ALT de l'image définie par l'argument <icon_image> . Cette étiquette est utilisée par le CGI d'état. |