lxlogger und grafana stat visualsierung

LxLogger und Grafana – Die Stat Visualisierung

Im vierten Teil unserer Serie zur Erklärung der Grafana Funktionen möchten wir dir die Erstellung von Stat- Visualisierungen näher erläutern. Dabei erfährst du mehr über den optimalen Einsatz dieser Visualisierungsart und deren Verwendung innerhalb von Grafana in Verbindung mit deinem Loxone Smarthome. Falls du Hilfe beim Anlegen von Graph Visualisierungen benötigst, möchten wir dich auf unseren letzen Beitrag "LxLogger und Grafana - Die Funktionen der Graph Visualisierung" hinweisen.

Allgemein

Visualisierungen vom Typ Stat zeigen einen großen einzelnen Wert in Textform. Wahlweise kann außerdem im Hintergrund ein Flächendiagramm mit den letzten Datenpunkten angezeigt werden.

Anzeigeeinstellungen

  • Show - Definiert wie Grafana die Werte anzeigt
    • Calculate - Zeigt einen berechneten Wert basierend auf allen Daten an
      • Calculation - Definiert die Funktion für die Berechnung des Wertes
    • All values - Zeigt einen separaten Wert für alle Datenpunkte an
      • Limit - Definiert wieviele Werte im Panel angezeigt werden sollen
  • Fields - Auswahl eines Feldnamen oder Typ für die Bestimmung der Werte
  • Value - Auswahl einer Funktion für das Filtern von mehren Werten zu einem einzelnen Wert
  • Orientation - Definiert die Art der Ausrichtung des Panels
    • Auto - Grafana wählt die beste Option, basierend auf den ausgewählten Werten
    • Horizontal - Ausrichtung von links nach rechts
    • Vertical - Ausrichtung von oben nach unten
  • Text mode - Legt fest welcher Text vom Panel dargestellt werden soll. Ist beispielsweise der Wert nicht wichtig, aber der Name und die Farbe, kann in den Name Modus umgeschalten werden. Der Wert wird immer noch für die Ermittlung der Farbe herangezogen und erscheint auch im Tooltip
    • Auto - Wenn die Daten aus mehreren Datenabfragen bestehen, wird der Name und Wert angezeigt
    • Value - Nur der Wert wird im Panel angezeigt
    • Value and name - Es wird immer der Name und Wert angezeigt
    • Name - Es wird nur der Name angezeigt
    • None - Es wird nichts angezeigt. Der Name und der Wert erscheinen aber noch im Tooltip
  • Color mode
    • Value - Färbt nur den Wert und das Flächendiagramm
    • Background - Färbt auch den Hintergrund des Panels
  • Graph mode
    • None - Das Flächendiagramm im Hintergrund wird ausgeblendet und nicht dargestellt
    • Area - Das Flächendiagramm wird im Hintergrund, hinter dem Wert angezeigt
  • Alignment mode
    • Auto - Wenn ein einzelner Wert dargestellt wird, wird dieser im Panel zentriert. Existieren mehrere Datenabfragen, werden diese von links nach rechts im Panel angezeigt
    • Center - Der Wert wird im Panel zentriert

Beispiel - Anlegen eines Panels vom Typ Stat

Im Beispiel wollen wir dir zeigen, wie die Stats Visualisierung für die Anzeige einer Temperatur genutzt werden kann. Dazu wollen wir uns die aktuelle Temperatur, sowie im Hintergrund eine Trendkurve mit den Temperaturen der letzten Stunden anzeigen lassen. Das Diagramm sieht am Ende wie folgt aus:

Anlegen des Panels

Im ersten Schritt navigierst du auf ein Dashboard deiner Wahl, um mit dem Erstellen eines Panels zu beginnen. Wie du Panel's erstellst, erfährst du in unserem Beitrag LxLogger und Grafana – Panels im Fokus.

Definieren der Datenabfrage

Jetzt solltest du dich im Editor des neu erstellten Panels befinden. Nun gehen wir im unteren linken Bereich in den Tab Query in die Datenabfrage A. Hier wählen wir zunächst unser Measurement aus, in unserem Fall währe dies Temperatur. Da immer der aktuelleste Wert im Panel angezeigt werden soll, tauschen wir die Aggregatsfunktion von mean() auf last(). Im letzten Schritt wechseln wir die Group By Angabe von fill(null) auf fill(linear), sodass die Linie im Flächendiagramm ohne Unterbrechung gezeichnet werden kann. Nun sollte uns bereits das Flächendiagramm im Hintergrund angezeigt werden.

Visuelle Einstellungen für das Panel

Da nun die erforderlichen Daten für die Visualisierung bereitstehen, können wir mit den Einstellungen zur Anzeige des Panels fortfahren. Im ersten Schritt vergeben wir einen Titel für das Panel, sowie wahlweise ein Beschreibung. Dann wechseln wir zum Tab Display. Hier stellen wir sicher, dass als Anzeigeeinstellung, Calculate ausgewählt ist. Da immer der aktuelle Wert angezeigt werden soll (auch bei einem Datenpunkt mit keinem Wert, wählen wir für die Berechnungsfunktion Last (not null).

Anzeige der Einheit

Um die Einheit für den Wert in der Visualisierung anzuzeigen, wechseln wir in der rechten Seitenleiste in den Tab Field. Hier kann über das Feld Unit die Einheit definiert werden, in unserem Fall wäre dies Temperature / Celsius (°C). Um eine genauere Anzeige des Wertes zu erreichen, kann zusätzlich im Feld Decimals, die Anzahl der zu anzeigenden Nachkommastellen eingegeben werden. In unserem Fall tragen wir deshalb den Wert 1 ein.

Definition von Grenzwerten

Im letzten Schritt möchten wir noch die Farbe des Wertes und des Flächendiagramms, basierend auf dem aktuellen Wert verändern. Dies kann mit Grenzwerten (Thresholds) erreicht werden. Diese gliedern sich wie folgt:

  • 0-10°C - Farbe Blau
  • 10-15°C - Farbe Violett
  • 15-20°C - Farbe Orange
  • 20-30°C - Farbe Grün

Dazu wechseln wir erneut in den Tab Field und scrollen zum Block Thresholds. Über den Button + Add threshold können dann neue Grenzwerte hinzugefügt werden. Wir klicken nun 5x auf den Button, um alle Grenzwerte zu erstellen. Im nächsten Schritt können wir dann den Wert selbst, sowie die Farbe definieren. Dabei gehen wir von oben nach unten und starten mit dem höchsten Grenzwert wie oben definiert. Die Einstellungen sollten nun wie folgt aussehen:

Die Konfiguration des Diagramm's ist nun abgeschlossen und kann mit einem Klick auf den Save Button gespeichert werden. Mit einem Klick auf den Button Apply im rechten oberen Eck, gelangst du zudem auf dein Dashboard zurück. Hier kannst du je nach Bedarf noch die Größe des Panels auf dem Dashboard, sowie die Position anpassen.

Damit ist ein weiterer Beitrag zu unserer Grafana Reihe abgeschlossen. Wir hoffen erneut dir geholfen zu haben oder zumindest wertvolle Tipps im Umgang mit Grafana an die Hand geben konnten. Im nächsten Teil der Serie möchten wir dir die Visualisierungen "Gauge" bzw. "Bar Gauge" näher bringen. Schau also mal wieder vorbei oder folge uns auf FacebookTwitter und/oder Instagram um keinen Beitrag zu verpassen.