Changes between Version 19 and Version 20 of Doc/Monitoring/Nagios

Timestamp:

Jul 22, 2011, 2:25:40 PM (13 years ago)

Author:

/DC=org/DC=terena/DC=tcs/C=NL/O=Nikhef/CN=Ronald Starink ronalds@…

Comment:

--

Doc/Monitoring/Nagios

@@ -114 +114 @@
 Many service and host checks return performance metrics to the Nagios server. The performance data can be visualized in plots based on rrdtool using pnp4nagios.
 
+To enable visualization with pnp4nagios on the web interface, pnp4nagios must be enabled (via `PNP4NAGIOS_ENABLE`) and the base URL for pnp4nagios on the web server must be supplied (via `PNP4NAGIOS_BASE_URL`). The exact locations of the host and service metrics can be modified via variables `PNP4NAGIOS_HOST_ACTION_URL` and `PNP4NAGIOS_SERVICE_ACTION_URL`, although by default they are derived from the base location:
+
+{{{
+variable PNP4NAGIOS_ENABLE = true;
+variable PNP4NAGIOS_BASE_URL = '/nagios/html/pnp4nagios/index.php';
+variable PNP4NAGIOS_HOST_ACTION_URL = PNP4NAGIOS_BASE_URL + '?host=$HOSTNAME$';
+variable PNP4NAGIOS_SERVICE_ACTION_URL = PNP4NAGIOS_BASE_URL + '?host=$HOSTNAME$&srv=$SERVICEDESC$';
+}}}
+
+Every host or service for which visualization is required, should contain a `action_url` in its definition. Hosts that are derived from the generic host template `monitoring/nagios/generic_host` already have this definition:
+{{{
+"action_url" = PNP4NAGIOS_HOST_ACTION_URL;
+}}}
+However, the `action_url` must be set for every service for which it is desired (note that it may not be useful for all services!). The definition of the `load` service template in the example cluster (template sites/example/monitoring/nagios/services/load.tpl) contains an example:
+{{{
+'action_url' = PNP4NAGIOS_SERVICE_ACTION_URL;
+}}}
+
+Note: the above assumes that the Nagios server is configured to collect performance metrics.
+
 == Variable index ==