6.9. Integration of PNP4Nagios into Icinga Web

6.9. Integration of PNP4Nagios into Icinga Web
Prev	Chapter 6. User Interfaces	Next

6.9. Integration of PNP4Nagios into Icinga Web

6.9.1. Install PNP4Nagios
6.9.2. Templates Extension
6.9.3. Clearing the cache

Here we'll give you some instructions on how to integrate PNP4Nagios into the Icinga Web frontend. If you want to integrate PNP4Nagios into the Icinga Classic UI please follow the PNP4Nagios documentation.

Figure 6.40. Expander icon

On the left you will see the expander icon. Clicking on it opens a bar (shown below the OK sign).

Figure 6.41. Icon bar

On the right in the "PNP4Nagios" section there are two buttons.

Figure 6.42. Move icons to grid

Right-clicking on either of them and selecting "Move into grid" will move the appropriate icon into the grid.

Figure 6.43. New icons in grid

Selecting the new icon opens the PNP graph in a small window showing only one time frame or it will create a new tab showing the usual PNP view.

Clicking on "Setting" and selecting "Reset grid action icons" will remove the inserted icons restoring the default view.

Figure 6.44. Reset icon view

6.9.1. Install PNP4Nagios

Install PNP4Nagios as described in the PNP4Nagios documentation

Change the PNP4Nagios configuration to match your Icinga configuration. You probably may want to change these:

#> vi npcd.cfg

    user = icinga
    group = icinga
    log_file = /var/log/icinga/npcd.log
    perfdata_spool_dir = /var/icinga/spool/
    perfdata_file = /var/icinga/perfdata.dump

#> vi process_perfdata.cfg

    LOG_FILE = /var/log/icinga/perfdata.log
    XML_ENC = ISO-8859-1  # use if encountering national character issues

#> vi config.php 
    $conf['nagios_base'] = "/icinga/cgi-bin";

Note

Be sure to use existing paths, create them if necessary, and/or adapt the settings to your distribution.

Please verify that the Icinga command definitions for "process-host-perfdata-file" and "process-service-perfdata-file" (probably in etc/objects/commands.cfg) point to the same target directory as specified in perfdata_spool_dir.

6.9.2. Templates Extension

PNP integration is made with these extensions to be upgrade safe.

Excerpt from the INSTALL in contrib/PNP_Integration/

#> cat contrib/PNP_Integration/INSTALL
    ************************
    * INSTALLATION
    ************************

    * To install this addon, simply copy both xml files under templateExtensions
    * to your icinga-webs app/modules/Cronks/data/xml/extensions folder
    * and clear the app/cache/CronkTemplates folder
    * To remove it, just delete the extension files and clear the cache folder again

Install Script

Because it's only copying the two files mentioned there is no script. Sorry.

	Note
	Please note that you will have to reinstall the addon after Icinga-Web upgrade.

6.9.3. Clearing the cache

	Note
	If you edit any *.xml file you have to clear the cache afterwards!

#> rm -f app/cache/config/*.php

or /path/to/clearcache.sh

#> /usr/local/icinga-web/bin/clearcache.sh

That's all, you're done!

Prev	Up	Next
6.8. Introduction to Icinga Web	Home	Chapter 7. Advanced Topics