IP-Symcon Modul // Grafana

---

Dokumentation

Inhaltsverzeichnis

1. Funktionsumfang
2. Systemanforderungen
3. Installation
4. Konfiguration
5. Grafana
6. Grafana Tips
7. Changelog
8. ToDo Liste

1. Funktionsumfang

Dieses Modul bietet Grafana direkten Zugang zu allen geloggten Variablen. Alle geloggten Variablen stehen automatisch in Grafana als Metrics zu Verfuegung.

2. Systemanforderungen

• IP-Symcon ab Version 4.x
• Grafana Installation
• Grafana Plugin JSON by simpod

3. Installation

Über die Kern-Instanz "Module Control" folgende URL hinzufügen:

https://github.com/1007/Symcon1007_Grafana

Instanz hinzufuegen.

4. Konfiguration

Das Modul ist unter den Kerninstanzen zu finden. In der Konfiguration kann ein User und Passwort vergeben werden. Dies muss mit der Einstellung in Grafana Data Sources /JSON uebereinstimmen. Aktiviere unter AUTH - Basic auth. Siehe Bild unter Punkt 5. Beides ohne Authorisierung ist auch moeglich. Der Test im Grafana-Plugin zeigt auch dann "Data source is working" wenn Authorisierung fehlerhaft, weil nur die Verbindung getestet wird nicht die Authorisierung.

Wer den Debug sich anschauen will, ist die Instanz in den Kerninstanzen zu finden.

5. Grafana

Konfiguration des Plugins JSON by simpo zum Beispiel:

Grafiken in Grafana erstellen:

• Einloggen mit Port 3000.
• Dashboard erstellen
• Darin ein Panel, oder mehrere, erstellen
• Add Query . Darin JSON auswaehlen
• Unter Metric koennen alle geloggten Variablen ausgewaehlt werden.
• Erster Wert ist die ID
• Zweiter Wert ist der Name fuer die Legende ( aenderbar)
• URL auswaehlen fuer Webfront/IPSView unter Menuepunkt Share.

Erste Schritte mit Grafana von Attain

Mischen Grafiktypen

Optionale Einstellungen der Aggregationstufen: Fuer jeden Graph kann neben dem Feld "Metric" das Feld "Additional JSON Data" benutzt werden. Dort kann eine Aggregationstufe , als JSON String , fest vorgegeben werden. In der aktuellen Grafana Version heisst das Feld jetzt "Payload" !

• Stufe 0 Stuendliche Aggregation

• Stufe 1 Taegliche Aggregation

• Stufe 2 Woechentliche Aggregation

• Stufe 3 Monatliche Aggregation

• Stufe 4 Jaehrliche Aggregation

• Stufe 5 5-Minuetige Aggregation

• Stufe 6 1-Minuetige Aggregation

• Stufe 99 keine Aggregation ( maximale Aufloesung )

• TimeOffset Vergleich zwischen zB 2 Zeitraeumen {"TimeOffset" : 2592000} holt die Daten 30 Tage von der Vergangenheit

6. GrafanaTips

Aenderung in der Konfigurationsdatei von Grafana sollen nicht in der defaults.ini gemacht werden.Die Datei defaults.ini kopieren nach custom.ini oder grafana.ini.

Dienst neu starten.

Sollten die Grafiken im Webfront nicht angezeigt werden folgendes aendern in ini-Datei:

Von:

allow_embedding: false
cookie_samesite: lax

Nach:

allow_embedding: true
cookie_samesite: none

Neustart nicht vergessen

Wer Chrome ab Version 80 einsetzt und sich nicht einloggen kann, soll mal folgenden Eintrag in der Konfiguration ueberpruefen:

set cookie SameSite attribute. defaults to 'lax'. can be set to "lax", "strict", "none" and "disabled"
cookie_samesite = none

none funktioniert nicht mehr. Den Defaultwert 'lax' benutzen.

Wenn ihr in der Userverwaltung User nur mit Login habt. Dann kommt im Webfront/IPSView einmalig ein Anmeldebildschirm.

Wer nur den Graph braucht, ohne die Auswahlmoeglichkeiten fuer Zeiten, nimmt am Besten nur den Link unter Share-Panel-Embed

Hintergrundfarbe auf "Transparent" setzen funktioniert nicht. In die index.html folgende Zeile einfuegen

<link rel="stylesheet" href="https://....../user/Grafana/mygrafana.css" type="text/css">

Entsprechend die mygrafana.css erstellen und folgendes eintragen.

@charset "UTF-8";

.panel-container {
background-color: #xxxxxx !important;
border: 0px solid #FFFFFF !important;
}

Bei dem Plugin JSON by simpo die Version 0.30 benutzen. Die neueren Versionen benutzen ein anderes Protokoll.

7. Changelog

Version 1.0 Startup Version 1.1 Verschiedene Fehler behoben. Doku verbessert.

8. ToDoListe

Dokumentation verbessern.