From 8014501006ed855e4d387300c21509fc260180a5 Mon Sep 17 00:00:00 2001 From: phil Date: Thu, 29 Dec 2022 08:34:58 +0100 Subject: [PATCH] =?UTF-8?q?grafana:=20Doku=20vervollst=C3=A4ndigt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 38 +++++++++++++++++++++----------------- 1 file changed, 21 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 5fb6e50..75d31e2 100644 --- a/README.md +++ b/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 mit Icinga verknüpfen -Mit Grafana lassen sich die Performance-Daten aus den Icinga-Checks grafisch in Icinga-Web2 darstellen: -- Neue "Data Source" hinzufügen und InfluxDB als Datenquelle angeben +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 | Option | Wert | |--------|------| | Server | `http://localhost:8086` | | 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. - 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 das Dashboard ''icinga2-default'' öffnen und einen beliebigen http-Check auswählen - - ''Edit Panel'': - - 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 + - Dazu die Dashboard-Settings öffnen + - links im Menü *Variables* auswählen + - die entsprechende Variable anklicken + - Im Feld *Select variable type* den Wert *Query* wählen und unter *Query Options* das Query von der o.g. Modul-Seite eintragen +- 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) -- Verzeichnis `/etc/icingaweb2/modules/grafana` anlegen und Besitzrechte analog zu den anderen Verzeichnissen vergeben -- Modul in Icingaweb2 `/config/modules#!/grafana/config` konfigurieren: - - host: Grafana-Domain - - Default Dashboard UID: Dazu in Grafana eine Grafik öffnen und über die *Share*-Funktion die Panel-ID aus der URL kopieren - - Grafana access: Indirect proxy - - Authentication type: API Token -- Das Redering der Graphen erfolgt mit dem [Grafana Image Renderer](https://grafana.com/grafana/plugins/grafana-image-renderer) und Chromium -- [Hostalive](https://dokuwiki.tachtler.net/doku.php?id=tachtler:icinga2_-_grafana#icingaweb2add_new_grafana_graphhostalive)-Graph hinzufügen: +- 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, [siehe](https://dokuwiki.tachtler.net/lib/exe/detail.php?id=tachtler%3Aicinga2_-_grafana&media=tachtler:grafana:grafana_dashboard_icinga-default_share_uid.png) | + | Grafana access | Indirect proxy | + | Authentication type | API Token | +- [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 - - 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