grafana: Doku vervollständigt
This commit is contained in:
parent
711b572aab
commit
8014501006
1 changed files with 21 additions and 17 deletions
38
README.md
38
README.md
|
|
@ -15,28 +15,32 @@ Grafana
|
||||||
- Grafana aufrufen - der Erstlogin erfolgt mit `admin:admin`. Anschließend das Passwort ändern und in unsere Zugangsdatenbank eintragen.
|
- Grafana aufrufen - der Erstlogin erfolgt mit `admin:admin`. Anschließend das Passwort ändern und in unsere Zugangsdatenbank eintragen.
|
||||||
|
|
||||||
# Grafana mit Icinga verknüpfen
|
# Grafana mit Icinga verknüpfen
|
||||||
Mit Grafana lassen sich die Performance-Daten aus den Icinga-Checks grafisch in Icinga-Web2 darstellen:
|
Mit Grafana lassen sich die Performance-Daten aus den Icinga-Checks grafisch in Icingaweb2 darstellen:
|
||||||
- Neue "Data Source" hinzufügen und InfluxDB als Datenquelle angeben
|
- Neue *Data Source* hinzufügen und InfluxDB als Datenquelle angeben
|
||||||
| Option | Wert |
|
| Option | Wert |
|
||||||
|--------|------|
|
|--------|------|
|
||||||
| Server | `http://localhost:8086` |
|
| Server | `http://localhost:8086` |
|
||||||
| Datanbank | icinga2 |
|
| Datanbank | icinga2 |
|
||||||
- Unter `/org/apikeys` einen API-Schlüssel erzeugen
|
- Unter `/org/apikeys` einen API-Schlüssel erzeugen und den Schlüssel kopieren.
|
||||||
- Nun die Icinga-Dashboards unter `/dashboard/import` importieren. Dazu [hier](https://github.com/Mikesch-mp/icingaweb2-module-grafana/tree/master/dashboards/influxdb) die Dateien `base-metrics.json` und `icinga2-default.json` herunter laden.
|
- Nun die Icinga-Dashboards unter `/dashboard/import` importieren. Dazu [hier](https://github.com/Mikesch-mp/icingaweb2-module-grafana/tree/master/dashboards/influxdb) die Dateien `base-metrics.json` und `icinga2-default.json` herunter laden.
|
||||||
- Beim Import von `icinga2-default.json` müssen die [Queries](https://github.com/Mikesch-mp/icingaweb2-module-grafana/blob/master/doc/06-create-grafana-dashboards-influxdb.md#Templating) (Hostname, Service, Command) angepasst werden
|
- Beim Import von `icinga2-default.json` müssen die [Queries](https://github.com/Mikesch-mp/icingaweb2-module-grafana/blob/master/doc/06-create-grafana-dashboards-influxdb.md#Templating) (Hostname, Service, Command) angepasst werden
|
||||||
- Die Darstellung des Grafen für den http-Check anpassen, da sie ansonsten keine Aussagekraft hat:
|
- Dazu die Dashboard-Settings öffnen
|
||||||
- Dazu das Dashboard ''icinga2-default'' öffnen und einen beliebigen http-Check auswählen
|
- links im Menü *Variables* auswählen
|
||||||
- ''Edit Panel'':
|
- die entsprechende Variable anklicken
|
||||||
- Rechts in den Panel-Optionen: ''Axes'' --> ''Left Y'': Unit auf ''Seconds'' und ''Scale'' --> ''log(base 2)''
|
- Im Feld *Select variable type* den Wert *Query* wählen und unter *Query Options* das Query von der o.g. Modul-Seite eintragen
|
||||||
- Unten bei der Query-Abfrage: ''Transform'' --> ''Filter by name '' --> ''size'' deaktivieren
|
- Die Darstellung des Grafen für den http-Check anpassen, da es ansonsten keine Aussagekraft hat:
|
||||||
|
- Dazu das Dashboard ''icinga2-default'' öffnen und einen beliebigen http-Check auswählen und mit *Edit Panel* bearbeiten:
|
||||||
|
- Rechts in den Panel-Optionen: *Axes* --> *Left Y*: *Unit* auf *Seconds* und *Scale* --> *log(base 2)*
|
||||||
|
- Unten bei der Query-Abfrage: *Transform* --> *Filter by name* --> *size* deaktivieren
|
||||||
- Das [Icingaweb2-Modul](https://github.com/Mikesch-mp/icingaweb2-module-grafana|Icingaweb2-Modul) aktivieren. Automatisiert über die [Ansible-Rolle](https://git.systemausfall.org/systemausfall.org/ansible/src/branch/main/roles/icinga2)
|
- Das [Icingaweb2-Modul](https://github.com/Mikesch-mp/icingaweb2-module-grafana|Icingaweb2-Modul) aktivieren. Automatisiert über die [Ansible-Rolle](https://git.systemausfall.org/systemausfall.org/ansible/src/branch/main/roles/icinga2)
|
||||||
- Verzeichnis `/etc/icingaweb2/modules/grafana` anlegen und Besitzrechte analog zu den anderen Verzeichnissen vergeben
|
- Modul in Icingaweb2 `/config/modules#!/grafana/config` konfigurieren:
|
||||||
- Modul in Icingaweb2 `/config/modules#!/grafana/config` konfigurieren:
|
| Option | Wert |
|
||||||
- host: Grafana-Domain
|
|--------|------|
|
||||||
- Default Dashboard UID: Dazu in Grafana eine Grafik öffnen und über die *Share*-Funktion die Panel-ID aus der URL kopieren
|
| host | Grafana-Domain |
|
||||||
- Grafana access: Indirect proxy
|
| Default Dashboard UID | Dazu in Grafana eine Grafik öffnen und über die *Share*-Funktion die Panel-ID aus der URL kopieren, [siehe](https://dokuwiki.tachtler.net/lib/exe/detail.php?id=tachtler%3Aicinga2_-_grafana&media=tachtler:grafana:grafana_dashboard_icinga-default_share_uid.png) |
|
||||||
- Authentication type: API Token
|
| Grafana access | Indirect proxy |
|
||||||
- Das Redering der Graphen erfolgt mit dem [Grafana Image Renderer](https://grafana.com/grafana/plugins/grafana-image-renderer) und Chromium
|
| Authentication type | API Token |
|
||||||
- [Hostalive](https://dokuwiki.tachtler.net/doku.php?id=tachtler:icinga2_-_grafana#icingaweb2add_new_grafana_graphhostalive)-Graph hinzufügen:
|
- [Hostalive](https://dokuwiki.tachtler.net/doku.php?id=tachtler:icinga2_-_grafana#icingaweb2add_new_grafana_graphhostalive)-Graph in Icingaweb2 hinzufügen:
|
||||||
|
- Neuen Graphen unter `grafana/graph` anlegen
|
||||||
- Dashboard name: base-metrics
|
- Dashboard name: base-metrics
|
||||||
- Dashborad UID und Panel-ID erneut aus dem Share-Link kopieren
|
- Dashborad UID und Panel-ID erneut aus dem Share-Link einer base-metrics-Grafik kopieren
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue