From dc2d32a5fbe5e59efee6ac899928af4fd9fdeb0c Mon Sep 17 00:00:00 2001 From: Thomas Gelf Date: Tue, 16 Feb 2016 17:09:26 +0100 Subject: [PATCH] README.md: clean up --- README.md | 50 ++++++++++++++++++++++++-------------------------- 1 file changed, 24 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index 80890f0..7a2974c 100644 --- a/README.md +++ b/README.md @@ -19,11 +19,32 @@ frontend. * Icinga 2 v2.4.0 using the new Graphite tree in ([#9461](https://dev.icinga.org/issues/9461)). * Graphite and Graphite Web +## Prepare Icinga2 + +Enable the graphite feature: + + icinga2 feature enable graphite + +Adjust it's configuration in `/etc/icinga2/features-enabled/graphite.conf`: + +``` +library "perfdata" + +object GraphiteWriter "graphite" { + host = "127.0.0.1" + port = 2003 + enable_send_thresholds = true +} +``` + +And then restart Icinga2. Enabling thresholds is not a hard requirement. +However, some templates look better when they are able to render a max +values or similar. ## Installation -Just extract this to your Icinga Web 2 module folder. Enable the graphite -module in your Icinga Web 2 frontend +Just extract/clone this module to a `graphite` subfolder in your Icinga +Web 2 module path. Enable the graphite module in your Icinga Web 2 frontend (Configuration -> Modules -> graphite -> enable) and it should work out of the box. @@ -42,38 +63,15 @@ webserver is running as). Example for RHEL/CentOS/Fedora: chown -R apache:icingaweb2 /etc/icingaweb2/modules/graphite -Edit `/etc/icingaweb2/modules/graphite/config.ini` and set `web_url` +Edit `/etc/icingaweb2/modules/graphite/config.ini` and set `web\_url` to the Graphite web host. [graphite] web_url = http://my.graphite.web -Example for Icinga 2 v2.4.x: - - host_pattern = icinga2.$hostname - You don't need any configuration in your Icinga 2 installation (e.g. additional custom vars). -### Templates - -There are several sample templates shipped with this module. - -When using the Icinga 2 v2.4.x+ tree, you may filter based on - -* host name -* service name -* check command name (similar to other graphing solution such as PNP) - - - -## TODO - -* Web based configuration -* Additional filters -* Tree integration for detail views - - ## Testdrive Icinga 2 and Graphite feature enabled: