Skip to content

Commit

Permalink
Merge branch 'master' of github.com:Mikesch-mp/icingaweb2-module-grafana
Browse files Browse the repository at this point in the history
  • Loading branch information
Mikesch-mp committed Apr 6, 2023
2 parents 792c4cf + ae1cd1d commit 96e6c38
Showing 1 changed file with 7 additions and 11 deletions.
18 changes: 7 additions & 11 deletions doc/02-installation.md
Expand Up @@ -6,8 +6,8 @@ to the latest version, please [read on here](05-update.md).

## Requirements

* [Icinga Web 2](https://www.icinga.com/products/icinga-web-2/) (>=
2.11)
* [Icinga Web 2](https://github.com/Icinga/icingaweb2) (>= 2.11)
* [Icinga DB Web](https://github.com/Icinga/icingadb-web) (>= 1.02)
* [Grafana](https://grafana.com/) (>= 7.0)
* [InfluxDB](https://docs.influxdata.com/influxdb/) (>= 1.0) [Graphite](https://graphiteapp.org) as backend for Grafana
* [PHP 8.1](https://www.php.net) **with curl and gd enabled**
Expand Down Expand Up @@ -38,7 +38,7 @@ git clone "${REPO_URL}" "${TARGET_DIR}"
Replace the version number with the lates available version from [Latest Release](https://github.com/Mikesch-mp/icingaweb2-module-grafana/releases/latest)

```
MODULE_VERSION="2.0.0"
MODULE_VERSION="2.0.1"
ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
REPO_URL="https://github.com/Mikesch-mp/icingaweb2-module-grafana"
TARGET_DIR="${ICINGAWEB_MODULEPATH}/grafana"
Expand All @@ -61,9 +61,9 @@ icingacli module enable grafana

## Grafana Preparations

Depending on which mode (proxy/indirect proxy/direct/iframe) you want to use you have to set some configuration in Grafana
Depending on which mode (indirect proxy/iframe) you want to use you have to set some configuration in Grafana

### For 'proxy' or 'indirect proxy' mode
### For 'indirect proxy' mode

If you don't want anonymous access you have to create a user (with password) and enable basic auth in grafana.ini

Expand All @@ -90,7 +90,7 @@ If you want to allow anonymous access (read only) enable "Anonymous Auth" in gra

For API-Token access you need to create an API-Token with Grafana. See the [Grafana Docs](http://docs.grafana.org/tutorials/api_org_token_howto/#how-to-create-a-new-organization-and-an-api-token) on how to create one

### For 'direct' & 'iframe' mode
### For 'iframe' mode

You have to enable "Anonymous Auth" in grafana.ini and set default organization or users need
to be logged in into Grafana first to see graphs in Icinga Web 2.
Expand Down Expand Up @@ -120,11 +120,7 @@ Create a datasource depending on the metric backend you want to use.

### Import dashboards

Depending which metric backend (influxdb/graphite) you use, import the 2 provided dashboards.
Depending which metric backend (influxdb/graphite) you use, import the provided dashboards.

#### icinga2-default dashboard
![Grafana import icinga2-default dashboard](images/grafana-import-icinga2-default-dashboard.png "Grafana import icinga2-default dashboard")

#### base-metrics dashboard
![Grafana import base-metric dashboard](images/grafana-import-base-metrics-dashboard.png "Grafana import base-metric dashboard")

0 comments on commit 96e6c38

Please sign in to comment.