ElabNET Technik Forum

[jockel]

Link zu diesem Beitrag: Alles auswählen

[url=https://forum.timberwolf.io/app.php/kb/viewarticle?a=22&sid=811185a35472f743cee74432a6dad7b1]Knowledge Base - 4.3.3 Parametrierung von einzelnen Graphen[/url]

---

An einem einfachen "Schritt für Schritt" Beispiel soll im folgenden gezeigt werden, wie eine erste Grafik in Grafana angelegt werden kann. Ziel ist es, Temperatur und Luftfeuchte in einer Verlaufsgrafik darzustellen. Dabei sollen beide Werte je einer Y-Achse zugeordnet und mit korrekten Einheiten dargestellt werden. Quelle für die Darstellung ist die vom Timberwolf Server angelegte Aufzeichnung der vom KNX-Bus empfangenen Werte. Genau so ließen sich aber auch die Werte der 1-Wire Sensoren darstellen.

Im folgenden die einzelnen Schritte zur Umsetzung:


1. Aufruf von Grafana

Grafana ist eine auf dem Timberwolf Server vorinstallierte Webanwendung, die im Browser bedient wird. Aufrufen lässt sich Grafana entweder über den Link auf der Seite "Time Series" oder direkt unter der folgenden Adresse: https://timberwolf145.local/proxy/grafana/?orgId=1
Die Seriennummer des Timberwolf Servers (hier 145) muss dabei an den eigenen Server angepasst werden. Der Link kann in den Lesezeichen des Browsers gespeichert werden.




2. Anmelden in Grafana

Beim ersten Aufruf von Grafana erscheint die Anmeldemaske. Der vom Timberwolf Server vorgegebene Standardbenutzer lautet "admin" mit dem Passwort "admin". Dieses Passwort sollte aus Sicherheitsgründen geändert werden. Bei Bedarf können auch weitere Benutzer angelegt werden.


3. Anlegen eines neuen Dashboards

Ein neues Dashboard wird über das oben links auf dem Bildschirm zu sehende "+" Zeichen angelegt. Sobald die Maus darauf zeigt, klappt ein Menü aus in dem das Dashboard mit "Create Dashboard" angelegt werden kann.




4. Festlegen des Typs des ersten Panels

Beim Anlegen des Dashboards erstellt Grafana gleichzeitig auch das erste Panel innerhalb dieses Dashboards. In dem auf "Create Dashboard" folgenden Dialog wird abgefragt welchen Typ dieses Panel haben soll. Weitere Panels, auch unterschiedlicher Typen, können später zum Dashboard hinzugefügt werden. Für dieses Beispiel bitte den Typ "Graph" auswählen, worauf ein neues Dashboard mit einer Verlaufsgrafik angezeigt wird. Diese Verlaufsgrafik enthält zunächst von Grafana generierte Testdaten.




6. Namen des Dashboards festlegen

Der Konfigurationsdialog des Dashboards kann über das kleine "Zahnrad" Icon oben rechts aufgerufen werden. In dem sich öffnenden Dialog reicht es, zunächst einmal einen sinnvollen Namen für das Dashboard zu vergeben, in diesem Beispiel "Demo".






7. Speichern des Dashboards

Jetzt kann das neu erstellte Dashboard zum ersten mal gespeichert werden. Dazu entweder die Tastenkombination Strg+S betätigen oder auf das kleine Disketten-Symbol oben rechts klicken. Die Ablage der Daten organisiert Grafana intern, es muss kein Speicherort ausgewählt werden.

Beim Speichern fragt Grafana nach einer kurzen Beschreibung der Änderungen, um diese später nachvollziehen zu können. Der Dialog kann aber auch leer bleiben.

An der Stelle auch der Hinweis, dass daran gedacht werden sollte, beim Arbeiten an einem Dashboard regelmäßig zu speichern. Auch wenn Grafana sehr stabil läuft, ist es sonst nicht auszuschließen, dass z.B. bei einem Absturz des Browsers die Arbeit vieler Stunden verloren ist.




8. Festlegen der Größe des Panels

Die Größe des Panels kann in Höhe und Breite durch Ziehen mit der Maus an der unteren rechten Ecke geändert werden. In diesem Beispiel nimmt das Panel die volle Breite des Dashboards ein, es ist aber auch möglich, neben dem Panel ein weiteres in der gleichen Reihe darzustellen.




9. Festlegen des Namens des Panels
Zum Öffnen des Konfigurationsdialogs des Panels mit der Maus neben den Titel des Panels zeigen, woraufhin rechts neben dem Namen ein Pfeil nach unten eingeblendet wird. Wird darauf geklickt, klappt ein Menü aus, in dem "Edit" zu wählen ist".

Zunächst kann auf dem Tab "General" unter "Titel" ein Name für das Panel festgelegt werden, in diesem Beispiel wurde "Temperatur" gewählt.






10. Löschen der Testdaten
Die auf dem Panel darzustellende(n) Datenreihe(n) wird im Tab "Metrik" festgelegt. Als erstes sollten die von Grafana erzeugten Testdaten gelöscht werden. Dazu auf das "Mülleimer" Symbol ganz rechts in der Zeile mit "Test data random walk" klicken.




11. Auswahl der Datenreihe (Temperatur)
Anschließend kann die erste Datenreihe zur Darstellung in der Verlaufsgrafik definiert werden. Dazu muss zunächst die auf dem Timberwolf Server standardmäßig erzeugte Datenquelle ausgewählt werden. Dazu bitte im Ausklappmenü "Data Source" die "Timberwolf Timeseries DB" auswählen.

Anschließend über "add query" (blaue Schaltfläche) eine neue Abfrage definieren. In diesem Beispiel wird der Temperaturwert auf der GA 11/2/60 gesendet, dieser Wert muss an die eigenen Gegebenheiten angepasst werden. Im Editor können die einzelnen Felder geändert werden, nachdem darauf geklickt wurde, meist erfolgt die Auswahl dann mit Hilfe der Maus.

Für dieses Beispiel wurde folgende Abfrage definiert:
FROM default KNX_LINE1 WHERE GA = 11/2/60
SELECT field (Val)
FORMAT AS Time Series
ALIAS BY: Temperatur außen

Achtung: Dabei ist darauf zu achten, dass hinter Select wirklich field(Val) aufgeführt wird. Mit dem als Default dort stehenden field(value) werden keine Daten angezeigt.

Die Einträge unter "Group" können erst einmal leer bleiben bzw. entfernt werden.
Unter "Alias by" kann der Name angegeben werden, unter dem der Graph angezeigt werden soll. In diesem Beispiel "Temperatur außen"



Nach der Definition der Abfrage zeigt Grafana die Werte aus der Time Series Datenbank des Timberwolf Servers an. Dabei kann der darzustellende Zeitraum per Mausklick auf "last 6 hours" oben rechts geändert werden. Dort kann auch ein "Refresh Intervall" gewählt werden, nach Ablauf dieser Zeit wird Grafana den Graphen jeweils mit neuen Werten aus der Datenbank aktualisieren.




12. Auswahl der Datenreihe für den zweiten Graphen (Luftfeuchte)

Wiederum wird das "Edit" Menü im Titel des Panels aufgerufen und auf den Tab "Metrik" gewechselt. Die Abfrage kann definiert werden, nachdem unten links, neben "B" auf die Auswahl "Add Query" geklickt wurde. Die zweite Abfrage wird analog zur ersten erstellt, als Alias wurde "Feuchte" festgelegt. In diesem Beispiel wird die GA "11/0/121" für die Luftfeuchte verwendet, diese GA ist ebenfalls an die eigenen Gegebenheiten anzupassen.




13. Auswahl der rechten Y-Achse für die Luftfeuchte

Grafana zeichnet zunächst beide Graphen gegen die linke Y-Achse, was aufgrund des unterschiedlichen Wertebereichs und der verschiedenen Einheiten von Temperatur und Luftfeuchte nicht ideal ist.

Zur Auswahl der rechten Y-Achse für die Luftfeuchte zunächst auf den Tab "Axis" wechseln, dort Einheit und ggf. auch den Wertebereich für beide Y-Achsen auswählen. Dazu jeweils auf den Pfeil hinter "Unit" klicken und dann die Einheiten. In diesem Beispiel wurde für die linke Y-Achse "Temperatur" und anschließend "Celsius(°C)" ausgewählt, für die rechte Achse "none" and dann "Humidity (%H)"

Für beide Y-Achsen getrennt können unter "Y-Min" und "Y-Max" jeweils auch noch der Wertebereich, unter "Decimals" die Dezimalstellen und unter "Label" eine Bezeichnung definiert werden. Meist sind die Automatiken von Grafana aber schon gut genug.

Anschließend kann die Luftfeuchte der rechten Y-Achse zugewiesen werden. Dazu die kurze farbige Linie vor "Feuchte" anklicken. Es erscheint ein Menü in dem die Farbe des jeweiligen Graphen festgelegt und mit "right" die rechte Y-Achse ausgewählt werden kann. Für das Beispiel wurde im gleichen Menü zusätzlich noch die Linienfarbe der Temperatur auf rot und die der Feuchte auf blau geändert.




14. Definition der Legende

Als Standard verwendet Grafana nur eine kurze Legende, in der die jeweilige Farbe der einzelnen Graphen sowie ihr Name (Alias) aufgeführt werden. Zusätzliche Angaben, wie z.B. der aktuelle Werte sowie Minima und Maxima können über den Reiter "Legend" festgelegt werden. Alle statistischen Werte, wie Minimum und Maximum beziehen sich dabei auf den aktuell dargestellten Zeitraum, als aktueller Wert wird der neueste aus der Datenbank ausgelesene Wert dargestellt.

Bei der Anzeige verschiedener statistischer Werte ist die tabellarische Form meist übersichtlicher, auch diese kann in diesem Menü aktiviert werden.




15. Anpassen der Anzeigeoptionen

Im Reiter "Display" können verschiedene Optionen für die Anzeige der einzelnen Graphen ausgewählt werden. Unter anderem lässt sich festlegen, dass die einzelnen Messwerte als Punkte hervorgehoben werden. Das Verbinden der Messwerte mit einer Linie eignet sich gut für physikalische Messgrößen, z.B. die Temperatur, die Darstellung in Stufen vor allem bei Zeitreihen die binäre Werte (an/aus) enthalten oder bei der Verwendung von Aggregatfunktionen in der Abfrage.



16. Abschluss

Nach Abschluss der Arbeiten am Panel kann es über das Symbol mit dem blauen Pfeil, oben rechts, verlassen werden. Anschließend sollte das Dashboard noch einmal gespeichert werden.

Der fertige Graph sieht folgendermaßen aus: