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 à 40×40 pixels.

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

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¹⁾:

file wap.png 
wap.png: PNG image data, 40 x 40, 8-bit/color RGBA, non-interlaced

Installer l'outil pngtogd2 et créer le fichier:

sudo apt install libgd-tools
pngtogd2 wap.png wap.gd2 0 1

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

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

# 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
}

Après modification, recharger les fichiers de configuration:

systemclt reload nagios.service

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.

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

# 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.

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.

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