# Grafana

Diese Seite beschreibt den Umgang mit [Grafana](https://www.grafana.com/), einem Tool zur Visualisierung von Daten.

## Theorie

Aus der [Wikipedia-Seite](https://de.wikipedia.org/wiki/Grafana):

[![grafana_logo.png](https://wiki.oberlab.de/uploads/images/gallery/2024-05/scaled-1680-/eno0aIZ4e0w8CTOK-grafana-logo.png)](https://wiki.oberlab.de/uploads/images/gallery/2024-05/eno0aIZ4e0w8CTOK-grafana-logo.png "Grafana Logo - Quelle Wikipedia")

> Grafana ist eine plattformübergreifende Open-Source-Anwendung zur grafischen Darstellung von Daten aus verschiedenen Datenquellen wie z. B. InfluxDB, MySQL, PostgreSQL, Prometheus und Graphite.
> 
> Die erfassten Rohdaten lassen sich anschließend in verschiedenen Anzeigeformen ausgeben. Diese können dann zu sogenannten Dashboards zusammengefügt werden. Die Anzeigemöglichkeiten und Datenquellen können zudem mittels Plug-ins erweitert werden.

## Zugriff auf InfluxDB Daten

Der Zugriff auf die InfluxDB erfolgt mittels User/Passwort. Es empfiehlt sich einen dedizierten Satz an Credentials zu verwenden, und dem Benutzer nur Leserechte zu gewähren. Sollen mehrere Datenbanken verwendet werden, muss jede als Datenquelle in Grafana angelegt werden. Dabei können auch unterschiedliche Credentials verwendet werden.

Beim Anlegen einer neuen InfluxDB Datenquelle sind folgende Infos anzugeben:

- URL: in dem typischen Docker-Setup ist das http://influxdb:8086
- Auth: Basic auth
- Basic auth details : credentials
- InfluxDB details : nochmal die Credentials

\_Save & Test\_ sollte eine grüne Bestätigung bringen, dass die Verbindung richtig konfiguriert ist

## Benutzung der Oberfläche

### Graphen

Ein Punkt auf dem jeweiligen Graphen entspricht einer übertragenen Messung. Die Kurven der 3 Counter sind farblich unterschiedlich dargestellt.

[![grafana_user_1.png](https://wiki.oberlab.de/uploads/images/gallery/2024-05/scaled-1680-/l2rgNJBZq85wki87-grafana-user-1.png)](https://wiki.oberlab.de/uploads/images/gallery/2024-05/l2rgNJBZq85wki87-grafana-user-1.png "Beispiel eines Graphen mit 3 Messreihen")

Man kann die Kurve eines einzelnen Counters anzeigen lassen, wenn man auf dessen Namen in der Legende unter dem Graphen klickt. Dabei wird der Name hervorgehoben, die anderen Namen bleiben grau (im Beispiel ist schwaz-pxc-03 selektiert). Eine Mehrfachselktion ist möglich, man hält CTRL/STRG gedrückt während man die Messreihen anklickt.

[![grafana_user_2.png](https://wiki.oberlab.de/uploads/images/gallery/2024-05/scaled-1680-/mrcPODuSQJXTcLT4-grafana-user-2.png)](https://wiki.oberlab.de/uploads/images/gallery/2024-05/mrcPODuSQJXTcLT4-grafana-user-2.png "Beispiel eines Graphen mit 3 Messreihen. Eine Messreihe ist selektiert")

Sind keine Daten empfangen worden, werden die Linien der Graphen einfach mit demselben Wert weitergzogen, bis zum nächsten Datenpunkt (grüner Pfeil).

[![grafana_user_3.png](https://wiki.oberlab.de/uploads/images/gallery/2024-05/scaled-1680-/ogwebZh5M4n3VBBh-grafana-user-3.png)](https://wiki.oberlab.de/uploads/images/gallery/2024-05/ogwebZh5M4n3VBBh-grafana-user-3.png)

## Navigation im Dashboard

### Ändern des Zeitfensters

Per Default werden die Messwerte der letzten 24h dargestellt. Dies kann über den Knopf in der oberen Menüleiste geändert werden (orangefarbener Pfeil).

[![grafana_navi_1.png](https://wiki.oberlab.de/uploads/images/gallery/2024-05/scaled-1680-/xqgzVICI4rOxSY1x-grafana-navi-1.png)](https://wiki.oberlab.de/uploads/images/gallery/2024-05/xqgzVICI4rOxSY1x-grafana-navi-1.png)

Beim Klicken öffnet sich ein kleines Fenster, in dem man auf der rechten Seite ein vordefiniertes Zeitfenster auswählen kann (mit dem Mausrad scrollen, um weitere zu sehen, man kann bis zu 2 Jahre auswählen). Auf der rechten Seite kann man das Fenster (von – bis) händisch eingeben, falls eine genauere Kontrolle erwünscht ist.

### Dashboard aktualisieren

Per Default aktualisiert sich das Dashboard jede Minute. Das kann in der oberen Menüleiste geändert werden (orangefarbener Knopf). Dabei stehen Aktualisierungsraten von *alle 5 Sekunden* bis *jeden Tag* zur Auswahl.

[![grafana_navi_2.png](https://wiki.oberlab.de/uploads/images/gallery/2024-05/scaled-1680-/3Mn6XUbvpg8r1HKK-grafana-navi-2.png)](https://wiki.oberlab.de/uploads/images/gallery/2024-05/3Mn6XUbvpg8r1HKK-grafana-navi-2.png)

Eine sofortige Aktualisierung der Daten kann mittels dem Knopf links davon (grüner Pfeil) erzwungen werden.