UPGRADE IP 9 verfügbar!
Timberwolf VISU jetzt mit NEUEM Layout Editor
Freie Anordnung, Reihenfolge und Größe der Widgets - viele weitere Verbesserungen
Infos im Wiki: https://elabnet.atlassian.net/l/cp/06SeuHRJ

NEU! Insider & Leistungsmerkmale FÜR ALLE freigeschaltet
Damit kann nun jeder das Upgrade vornehmen und VISU & IFTTT testen. Alle Info hier: viewtopic.php?f=8&t=5074

4.3.2 Grafana-Konzepte: Datasource, Dashboards, Panels

Beschreibung: Step by Step Erklärung zu Grafana

Kategorie: Grafana

Link zu diesem Beitrag: Alles auswählen

[url=https://forum.timberwolf.io/app.php/kb/viewarticle?a=21&sid=62eed2fe8584feee4d2fd705c88ff30b]Knowledge Base - 4.3.2 Grafana-Konzepte: Datasource, Dashboards, Panels[/url]

Zum Verständnis von Grafana ist es hilfreich, die grundlegenden Begriffe und Konzepte zu verstehen, die hier kurz erläutert werden sollen:

Data sources:

Grafana kann Daten aus verschiedenen Quellen, z.B. InfluxDB, PostgreSQL oder MySQL verarbeiten.

Eine "Data source" (Datenquelle) fasst die Einstellungen für jede dieser Quellen zusammen, insbesondere
  • den Typ der verwendeten Datenbank,
  • die Adresse des Servers,
  • den Namen der Datenbank
  • sowie die Login-Daten.
Welche Parameter genau angegeben werden müssen, hängt unter anderem von der für die Datenquelle verwendeten Datenbank ab.

Die einzelnen Datenquellen erlauben unterschiedliche Arten der Abfrage, so kann z.B. die vom Timberwolf Server verwendete InfluxDB Daten bei der Abfrage aggregieren. Sie ist damit sehr gut für die Verwendung als Datenbank zur Darstellung von Zeitreihen und von Durchschnittswerten in Grafana geeignet.

Auf dem Timberwolf Server ist die folgende Datenquelle vordefiniert:

Name: Timberwolf Timeseries DB
Backend: InfluxDB Timeseries Datenbank

In dieser Datenbank speichert der Timberwolf Server sowohl das Log (über den KNX Bus empfangenen Telegramme, siehe KNX-Busmonitor) sowie die Zeitserien (z.B. von den 1-Wire Geräten und ab BETA 17 auch von KNX-Objekten und jedem anderen Objekt).

Weitere Datenquellen, z.B. zur Abfrage schon vorhandener Datenbanken, können vom Anwender in den Einstellungen hinzugefügt werden. Dazu links über das Zahnradsymbol die Menü "Configuration" und dort den Unterpunkt "Data Sources" aufrufen.


Dashboards:

Grafana organisiert die Darstellung von Graphen in einzelne Seiten, sogenannte Dashboards. So können zusammengehörige Werte auf einer Seite zusammengefasst werden. Dashboards können wiederum verschiedene Panels (s.u.) aufnehmen, die die eigentliche Darstellung der Daten übernehmen. Dashboards selbst können in Ordner strukturiert werden. Innerhalb eines Dashboards können Daten aus unterschiedlichen Quellen (s. Data source) dargestellt werden, solange dafür verschiedene Panels verwendet werden.

Darüber hinaus erlauben Dashboards gemeinsame Einstellungen für alle auf diesem Dashboard dargestellten Panels (z.B. der darzustellende Zeitrahmen). Die meisten dieser Einstellungen können dann wiederum in den einzelnen Panels des Dashboards überschrieben werden.

Dashboards können als JSON Dateien exportiert oder importiert werden. Diese Funktion ist sehr gut als Backup und für die Migration vorhandener Grafana Dashboards auf den Timberwolf Server geeignet.


Panels:

Panels übernehmen die eigentliche grafische Darstellung der Zeitreihen. Es gibt Panels unterschiedlicher Typen, z.B. zur Darstellung von Verlaufskurven, eines einzelnen Zahlenwerts, einer Tabelle von Werten und noch einiges mehr.

Panels werden auf einem Dashboard platziert und können dort per Drag & Drop mit der Maus verschoben werden. Auch die Größe eines Panels kann durch Ziehen an der unteren rechten Ecke mit der Maus angepasst werden. Innerhalb eines Dashboards organisiert Grafana die Panels in "Rows" (Reihen), wobei die einzelnen Reihen mehrere Panels nebeneinander aufnehmen können. Alle Panels innerhalb einer Reihe haben die gleiche Höhe. Alle Reihen haben die gleiche Breite, die je nach Auflösung des verwendeten Browsers skaliert wird.

Innerhalb des gleichen oder in verschiedenen Dashboards können problemlos Panels mit gleichen Daten mehrfach dargestellt werden, z.B. um die Daten unterschiedlich zu visualisieren oder Zeiträume zu vergleichen.

Nachdem ein Panel zum Dashboard hinzugefügt wurde, müssen im "Query Editor" (Abfrageditor) die zur Darstellung auf diesem Panel bestimmten Daten definiert werden. Dies ist im Abschnitt zum Anlegen eines Grafen näher beschrieben. Wie viele Daten auf dem jeweiligen Panel dargestellt werden können, hängt vom Panel ab. So kann z.B. ein Panel zur Darstellung eines Zahlenwertes nur genau einen Wert, eine Verlaufsgrafik aber beliebig viele Datenreihen darstellen. In der Praxis muss man sich trotzdem etwas beschränken, da es sonst schnell unübersichtlich wird.

Der Inhalt der einzelnen Panels kann auch in andere Anwendungen (z.B. eine Visualisierung) eingebunden werden, entweder statisch, eine durch Grafana gerenderte Grafikdatei, oder dynamisch. Näheres dazu im entsprechenden Abschnitt.

2019-02-26; Edit by StefanW