{{tag>sysadmin netadmin supervision nagios}}

====== Nagios: Associer une image/icône à un hôte ======

Il est possible d'associer une image/icône à un hôte ou un modèle. L'image sera affichée sur la cartographie des états (Statusmap) et sur certaines pages liées à l'hôte.

La documentation  recommande:

  * D' utiliser le format **gd2** (seulement pour la statusmap legacy).
  * De limiter la taille des images à 40x40 pixels.

Le but est de pouvoir générer la cartographie des états sans consommation excessive de ressources système. 

===== Générer une image GD2 =====

Ci dessous on génère un fichier au format gd2 à partir d'une image PNG:

Vérifier que le fichier png utilise 8 bits par canal en RGBA((Red, Green, Bule Alpha)):
<code bash>
file wap.png 
wap.png: PNG image data, 40 x 40, 8-bit/color RGBA, non-interlaced
</code>

Installer l'outil pngtogd2 et créer le fichier:
<code bash>
sudo apt install libgd-tools
pngtogd2 wap.png wap.gd2 0 1
</code>


Copier les fichiers PNG et GD2 dans le dossier des ressources, par défaut Nagios utilise les images placées dans le répertoire  **/usr/local/nagios/share/images/logos**


===== Mettre à jour l’hôte ou le modèle =====

Les attributs **icon_image** et **statusmap_image** de l'objet **host** permettent de définir l'image à utiliser:

<file>

# Exemple de définition d'hote
define host{
  ...
  icon_image              ubuntu.png          ; icone pour les nouvelles cartographies
  statusmap_image         ubuntu.gd2          ; icone statusmap legacy seulement
  ...
}
        
# Exemple de définition de modèle
define host {
  name                    generic-wap         ; nom du modèle
  use                     generic-host        ; hérite des valeurs par défaut du modèle generic-host
  icon_image              wap.png             ; icone pour les nouvelles cartographies
  icon_image_alt          icone point accès   ; 
  statusmap_image         wap.gd2             ; icone statusmap legacy seulement
  ...
  register                0
}

</file>

Après modification, recharger les fichiers de configuration:
<code bash>
systemclt reload nagios.service
</code>

===== Carte utilisateur =====


Dans le fichier de configuration des scripts CGI (cfi.cfg), il est possible de spécifier un fond de carte pour la carte utilisateur via la variable de configuration **statusmap_background_image**.

La cartographie des états à utiliser par défaut peut être spécifiée par la variable de configuration **default_statusmap_layout**


Il existe également une extension nagVis qui permet de définir un ensemble de cartes et des liaisons entre elles.

===== Troubleshooting =====

Les images au format GD2 ne sont pas affichées dans la Statusmap.

L'attribut **statusmap_image** de l'objet host et **le format GD2 ne sont utilisés que par la version legacy de la statusmap.** comme l'indique le commentaire présent dans le fichier cgi.cfg

<file>
# Note:  The image file may be in GIF, PNG, JPEG, or GD2 format.
# However, I recommend that you convert your image to GD2 format
# (uncompressed) but ONLY IF YOU WILL USE THE LEGACY MAP EXCLUSIVELY,
# as this will cause less CPU load when the CGI generates the image.
</file>

Les cartographies plus récentes utilisent les fichiers au formats PNG,JPG ou GIF définis par l'attribut **icon_image** de l'objet host.



===== Références =====

  * https://assets.nagios.com/downloads/nagioscore/docs/nagioscore/3/en/objectdefinitions.html
  *