icingaweb2-module-graphite/doc/02-Installation.md
2022-10-27 18:22:49 +02:00

1.5 KiB

Installing Icinga Web Graphite Integration

It is recommended to use prebuilt packages for all supported platforms from our official release repository. Of course Icinga Web itself is required to run its Graphite integration. The latter uses Graphite Web, so that is required as well. If they are not already set up, it is best to do this first.

The following steps will guide you through installing and setting up Icinga Web Graphite Integration.

Installing the Package

If the repository is not configured yet, please add it first. Then use your distribution's package manager to install the icinga-graphite package or install from source.

Prepare Icinga 2

Enable the graphite feature:

# icinga2 feature enable graphite

Adjust its configuration in /etc/icinga2/features-enabled/graphite.conf:

object GraphiteWriter "graphite" {
  host = "192.0.2.42"
  port = 2003
  enable_send_thresholds = true
}

And then restart Icinga2. Enabling thresholds is not a hard requirement. However, some templates look better if they are able to render a max value or similar.

Configuring the Icinga Web Graphite Integration

For required additional steps see the Configuration chapter.