Using Icons for Hosts and Services

Nagios provides the configuration parameter icon_image for hosts and services. In version 1.1.9i3 Multisite finally supports displaying these images.

All you have to do is to copy your icons into the directory /usr/share/check_mk/web/htdocs/images/icons. You find a few example icons there from the NUVOLA icon set (thanks to David Vignoni):

root@linux# cd /usr/share/check_mk/web/htdocs/images/icons/
root@linux# ls
cactus.png  missing.png        processor.png  shed.png
earth.png   networkdevice.png  README         terminal.png
home.png    printer.png        security.png

OMD users can copy their icons without root permissions into ~/local/share/check_mk/web/htdocs/images/icons (do rather not modify files below /omd/versions).

Configuring icons for hosts and services is best done in main.mk with extra_host_conf and extra_service_conf:

extra_host_conf["icon_image"] = [
  ( 'cactus.png', ['prod'],  ALL_HOSTS ), # all hosts with tag 'prod'
  ( 'tux.png',    ['linux'], ALL_HOSTS ), # all hosts with tag 'linux'
]

extra_service_conf["icon_image"] = [
  ( 'network.png', ALL_HOSTS, [ "NIC" ]), # all services beginning with NIC
  ( 'other.png',   ALL_HOSTS,  ALL_SERVICES ), # all other services
]

If your icons do not show up, then please check the following:

• Check if the icon_image is correctly added the the Nagios configuration. You can check this with check_mk -N yourhost.
• Check the error log of your webserver for messages about missing files. Maybe you missspelled the name of the icon or did not put it into the correct path.
• Make sure you did a check_mk -O after your changes to main.mk.