The www/pnp4nagios port

pnp4nagios-0.6.26p3 – Nagios/Icinga addon which graphs performance data (cvsweb github mirror)

Description

PNP is an addon to Nagios and Icinga which analyzes performance data
provided by plugins and stores them automatically into RRD-databases
(Round Robin Databases).

WWW: https://docs.pnp4nagios.org/

Readme

+-----------------------------------------------------------------------
| Running pnp4nagios on OpenBSD
+-----------------------------------------------------------------------

General
=======

Pnp4nagios has no default runtime dependencies to a monitoring tool,
as well as to a monitoring webinterface or web server. Example
instructions below are given for icinga, icinga-web and Apache2, as
well as icinga2, icinga-web2 and nginx.

Log file in ${VARBASE}/log/pnp4nagios will need to be rotated. Here is
a sample line for newsyslog.conf:

${VARBASE}/log/pnp4nagios/pnp4nagios.log _icinga:_icinga 644 7  250  * Z

Icinga, Icinga-web, Apache
==========================

Apache2 configuration
---------------------
Apache2 configuration for PNP4Nagios is stored under:
    ${VARBASE}/www/conf/modules.sample/pnp4nagios.conf

It needs to be enabled by running the following command:
# ln -s ../modules.sample/pnp4nagios.conf ${VARBASE}/www/conf/modules
# rcctl restart apache2

Icinga-web configuration
------------------------
To integrate PNP4Nagios into the Icinga Web frontend you will need to
install templates extensions which comes with icinga-web package:
% cd ${VARBASE}/www/icinga-web/app/modules/Cronks/data/xml/extensions
# ln -s pnp-host-extension.xml.dist pnp-host-extension.xml
# ln -s pnp-service-extension.xml.dist pnp-service-extension.xml

Icinga2, Icinga-web2, Nginx
===========================
Pnp4nagios runs with php_fpm behind nginx in a chrooted environment.

Prepare the chroot environment
------------------------------
 - follow the instructions in the rrdtool package README
   to chroot rrdtool
 - copy /bin/sh to ${VARBASE}/www/bin
 - copy ${SYSCONFDIR} ${VARBASE}/www${SYSCONFDIR}
 - copy ${LOCALBASE}/lib/kohana/system ${VARBASE}/www${LOCALBASE}/lib/kohana/system
 - edit ${VARBASE}/www${SYSCONFDIR}/config.php
   - ensure: $conf['rrdbase'] = "/pnp4nagios/rrd/";
   - ensure: $conf['nagios_base'] = "/icingaweb2";

Icinga2 configuration
---------------------
With Icinga2 enable the perfdata feature:

# icinga2 feature enable perfdata

Pnp4nagios will use the npcd daemon, and work in the 'bulk' mode.
In ${SYSCONFDIR}/npcd.cfg update the 'perfdata_spool_dir'
to point to '${VARBASE}/spool/icinga2/perfdata'. Additionally ensure
the 'perfdata_file_run_cmd_args' has a '--bulk' argument specified.

In ${SYSCONFDIR}/process_perfdata.cfg ensure the
RRDPATH setting points to '${VARBASE}/www/pnp4nagios/rrd'.

Finally enable npcd:

# rcctl enable npcd

Nginx configuration
-------------------
Below a minimal snippet for the nginx configuration:

server {

  ...

  location /pnp4nagios {

    alias ${VARBASE}/www/pnp4nagios;
  }

  location ~ ^(/pnp4nagios.*\.php)(.*)$ {


    root          /pnp4nagios;
    include       ${SYSCONFDIR}/nginx/fastcgi_params;

    fastcgi_pass  unix:run/php-fpm-pnp4nagios.sock;
    fastcgi_split_path_info ^(.+\.php)(.*)$;
    fastcgi_param PATH_INFO       $fastcgi_path_info;
    fastcgi_param SCRIPT_FILENAME $document_root/index.php;
  }
}

Php_fpm configuration
---------------------
Configure php_fpm pool, the most important configuration
entries:

[pnp4nagios]
listen = ${VARBASE}/www/run/php-fpm-pnp4nagios.sock
listen.owner = www
listen.group = www
listen.mode = 0660
user = _icinga
group = _icinga
chroot = ${VARBASE}/www

Icinga-web2 configuration
-------------------------
Pnp4nagios integration with Icinga-web2 is done via PNP
module, that can be found here:
 - https://github.com/Icinga/icingaweb2-module-pnp
For installation and configuration follow the modules
instructions.

RRD tweaks.
=====================
Optionally you may want to use rrdcached to reduce disk I/O.
Here is a sample /etc/rc.conf.local part:
rrdcached_flags=-b ${VARBASE}/www/pnp4nagios/rrd -m 0660 -s _icinga -l unix:${VARBASE}/www/pnp4nagios/rrd/rrdcached.sock -j ${VARBASE}/www/pnp4nagios/rrd//journal -p ${VARBASE}/www/pnp4nagios/rrd/rrdcached.pid -w 1800 -z 1800 -F -P FLUSH,PENDING
rrdcached_user=_icinga