5. FAQ

Standardbenutzer

Wie reichst du ein eigenes Projekt ein?

Wenn du dein eigenes (Klima-)Projekt unter https://bad-belzig.klima-daten.de/massnahmen-projekte/ darstellen möchtest, nutze bitte das Formular unter https://bad-belzig.klima-daten.de/projekt-einreichen/.

Wie erstellst du dir einen Klima-Daten-Account und was hast du davon?

Du kannst dir unter https://keycloak.klima-daten.de/realms/klima-dashboard/login-actions/registration einen eigenen Account erstellen. Damit hast du die Möglichkeit, unter Grafana eigene Visualisierungen und Dashboards zu erstellen. Außerdem können dir dann vom Administrator auch ggf. weitere Rechte (z.B. zur Bearbeitung von WordPress-Inhalten oder zur Anbindung neuer Datenquellen per Node-RED) vergeben werden.

Wie kannst du in Grafana ein eigenes Dashboard anlegen?

1. Melde dich in Grafana an und klicke auf das "+"-Symbol im linken Menü.

2. Klicke auf "Dashboard".

3. Du befindest dich nun im Bearbeitungsmodus für ein neues Dashboard. Du kannst ein Panel hinzufügen, indem du auf das "Panel hinzufügen"-Symbol klickst. Ein "Panel" in Grafana ist eine Visualisierung wie ein Diagramm, eine Tabelle, ein Singlestat usw.

4. Nachdem du auf "Panel hinzufügen" geklickt hast, kannst du die Art der Visualisierung auswählen (z.B. Graph, Singlestat, Tabelle, Heatmap etc.).

5. Danach musst du die Datenquelle auswählen, die du visualisieren möchtest. Das kann zum Beispiel eine SQL-Datenbank, eine Zeitreihendatenbank wie InfluxDB oder eine andere unterstützte Datenquelle sein.

6. Je nach Art der ausgewählten Datenquelle musst du eine Abfrage erstellen, die die Daten abruft, die du visualisieren möchtest. Die Art und Weise, wie du diese Abfrage erstellst, hängt stark von der spezifischen Datenquelle ab.

7. Du kannst verschiedene Optionen für das Panel konfigurieren, wie zum Beispiel den Darstellungstyp, Achsenbeschriftungen, Farbschemas und mehr.

8. Wenn du fertig bist, klicke auf "Zurück", um zur Dashboard-Übersicht zu gelangen. Du kannst dann weitere Panels hinzufügen oder vorhandene Panels bearbeiten.

9. Nachdem du alle Panels erstellt hast, kannst du den Titel deines Dashboards festlegen, indem du auf das Dashboard-Einstellungssymbol (ein Zahnrad) klickst und unter "Einstellungen" einen Namen eingibst.

10. Vergiss nicht, dein Dashboard zu speichern, indem du auf das Diskettensymbol klickst.

Das sind die grundlegenden Schritte zum Erstellen eines Dashboards in Grafana. Es gibt viele weitere Funktionen und Möglichkeiten zur Feinabstimmung, aber dies sollte dir einen guten Start geben.

Wie kannst du eine einzelne Datenvisualisierung teilen?

Um ein Panel in Grafana zu teilen, gehe folgendermaßen vor:

1. Navigiere zu dem Dashboard, das das Panel enthält, das du teilen möchtest.

2. Bewege den Mauszeiger über das Panel, das du teilen möchtest, um die Menüleiste anzuzeigen.

3. Klicke auf das "Teilen"-Symbol (ein Quadrat mit einem Pfeil), das in der oberen rechten Ecke des Panels erscheint.

4. Ein neues Fenster wird geöffnet, in dem du zwischen den Registerkarten "Link", "Einbetten" und "Snapshot" wählen kannst.

   • Link: Diese Option gibt dir einen direkten Link zu dem Panel, den du kopieren und mit anderen teilen kannst. Du kannst auch auswählen, ob der aktuelle Zeitbereich und Vorlagevariablen in den Link einbezogen werden sollen.

   • Einbetten: Diese Option gibt dir einen HTML-Code zum Einbetten des Panels auf einer anderen Webseite. Du kannst die Option "Aktuellen Zeitbereich einbeziehen" und "Vorlagevariablen einbeziehen" ebenfalls auswählen.

   • Snapshot: Diese Option erzeugt eine Momentaufnahme des Panels zu einem bestimmten Zeitpunkt. Dies kann nützlich sein, wenn du einen bestimmten Zustand des Panels teilen möchtest, ohne dass die Daten dynamisch aktualisiert werden.

5. Nachdem du die gewünschten Optionen ausgewählt hast, kannst du den Link oder den Einbettungscode kopieren und wie gewünscht verwenden.

Wie erstellst du eine Datenvisualisierung in Grafana?

Neue Datenvisualisierungen lassen sich am besten erstellen, in dem Du eine bestehende ähnliche Visualisierung kopierst. In Grafana kannst du ein Panel aus einem Dashboard kopieren und in ein anderes Dashboard oder an eine andere Position im gleichen Dashboard einfügen.

1. Gehe zum Dashboard mit dem zu kopierenden Panel: Öffne Grafana in deinem Webbrowser und navigiere zum Dashboard, das das Panel enthält, das du kopieren möchtest.

2. Öffne den Bearbeitungsmodus für das Dashboard: Klicke auf das Zahnrad-Symbol in der oberen rechten Ecke des Dashboards, um den Bearbeitungsmodus zu aktivieren. Du musst in den Bearbeitungsmodus wechseln, um Panels kopieren zu können.

3. Wähle das zu kopierende Panel aus: Klicke auf das Panel, das du kopieren möchtest, um es auszuwählen. Wenn es ausgewählt ist, wird ein Menü mit verschiedenen Optionen angezeigt.

4. Kopiere das Panel: Im Menü des ausgewählten Panels gibt es ein Symbol zum Kopieren (normalerweise ein Doppelblatt-Symbol oder ein Symbol mit einem Pfeil). Klicke auf dieses Symbol, um das Panel zu kopieren.

5. Gehe zum Ziel-Dashboard oder zur Ziel-Position: Jetzt musst du zum Dashboard gehen, wo du das Panel einfügen möchtest. Du kannst auch im gleichen Dashboard zur gewünschten Position scrollen, an der du das kopierte Panel einfügen möchtest.

6. Füge das Panel ein: Wenn du das Ziel-Dashboard geöffnet hast oder zur gewünschten Position im gleichen Dashboard navigiert hast, klicke auf das "+"-Symbol oder das "Panel hinzufügen"-Symbol an der gewünschten Position, um ein neues Panel hinzuzufügen.

7. Wähle die Option zum Einfügen des kopierten Panels: Nachdem du auf "Panel hinzufügen" geklickt hast, erscheint ein Menü, das dir verschiedene Möglichkeiten zur Erstellung des neuen Panels bietet. Such nach der Option, die es dir erlaubt, das zuvor kopierte Panel einzufügen ("Paste Panel from Dashboard").

8. Überprüfe und speichere das Dashboard: Nachdem du das Panel eingefügt hast, kannst du das Dashboard im Vorschaumodus anzeigen, um sicherzustellen, dass das Panel an der richtigen Stelle erscheint und wie erwartet funktioniert. Wenn alles in Ordnung ist, speichere das Dashboard, um die Änderungen zu übernehmen.

Admins

Wie erstellst du eine neue Seite/Maßnahme/Projekt in WordPress?

Es empfiehlt sich, eine bestehende Seite als Kopiervorlage für neue Seiten zu nutzen, damit die Gestaltung einheitlich bleibt. Dafür sind diese Schritte notwendig:

1. Navigiere zur Seitenübersicht.

2. Suche eine passende Seite als Vorlage (z.B. über die Suchfunktion).

3. Bewege den Mauszeiger über den Seitentitel, so dass die Bearbeitungsoptionen angezeigt werden. Klicke auf "Dupliziere Seite".

4. Passe bei der neuen Seite den Seiten-Titel und die URL an.

5. Bearbeite die Seite wie gewohnt im "Beaver Builder".

Wie fügst du eine neue Visualisierung zu einer Seite in WordPress hinzu?

Bei der Einbindung neuer Visualisierungen solltest Du zunächst einen vergleichbaren Abschnitt auf Deiner Seite duplizieren.

Anschließend kann die eingebundene Grafik per Doppelklick ausgewählt werden und in dem dann angezeigten Popup bearbeitet werden.

Den passenden Code zur Einbindung findest Du im Grafana bei dem entsprechenden Panel. Bewege den Mauszeiger über das Panal, so dass der Pfeil zu Bearbeitungsoptionen erscheint. Wähle hier die Option "Share" aus.

In den Share-Optionen wähle den Reiter "Embed" aus und kopiere den Code für das iFrame:

Der iFrame-Code sollte auch noch angepasst werden, damit der Zeitraum passt und sich die Darstellung besser an die Seite anpasst. Im folgenden Beispiel wurde der Anfangszeitpunkt auf 10 Jahre (120 Monate) vor Heute (&from=now-120m) und der Endzeitpunkt auf Heute (&to=now) gesetzt. Außerdem wurde die Breite der Darstellung auf 100% (width="100%") und die Höhe auf 400 Pixel (height="400") gesetzt:

<iframe src="https://grafana.bad-belzig.klima-daten.de/d-solo/FgabrasVz/einwohner-and-beschaftigung?orgId=1&from=now-120m&to=now&panelId=8" width="100%" height="400" frameborder="0"></iframe>

Was ist bei Grafana bei der Erstellung von Dashboards zu beachten?

Achte als Admin darauf, dass Dashboard vor der Bearbeitung durch normale Nutzer geschützt ist. Dafür lege das neue Dashboard entweder in einem bestehenden Ordner an und erstelle für Dein Dashboard einen neuen Ordner und passe die "Permissions" so an, dass die Dashboards in diesem Ordner nur von Admins bearbeitet werden dürfen.

Wie kannst du eine eigene Klima-Dashboard-Instanz für deine Kommune/Region aufsetzen?

Mittels der in dieser Doku beschriebenen und hier in Github abgelegten Komponenten kannst Du Dir auch ein eigene Klima-Dashboard erstellen. Essentiell für unser Setup sind Node-RED, InfluxDB und Grafana. Optional sind Wordpress, falls Du die Visualisierungen benutzerfreundlich anordnen und mit redaktionellem Inhalt anreichern willst, und Keycloak, das als Single-Sign-On dient.

Du brauchst für den Betrieb einen leistungsfähigen Webserver (ca. 16 GB RAM, ca. 8 vCPU) mit ausreichend Speicherplatz zur Speicherung aller Daten (abhängig von der Menge und Aktualisierungshäufigkeit der eingebundenen Daten).

Nach der Installation und initialen Konfiguration der einzelnen Komponenten (das sollte durch einen mit diesen Tools vertrauten Systemadministrator erfolgen) ist der größte Aufwand Einbindung der Datenquellen. Hier hat sich der folgenden Ablauf bewährt:

• Identifikation geeigneter Datenquellen
• Analyse der Datenquelle hinsichtlich der Möglichkeiten zum automatischen Abruf maschinenlesbarer Daten
• Konzeption der Dateneinbindung
  • Welche Daten sollen genau gespeichert werden?
  • Wie häufig sollen die Daten abgerufen werden?
  • Wie sollen die Daten visualisiert werden?
  • Müssen die Daten bei der Abfrage im Format verändert werden, damit die gewünschte Visualisierung möglich wird?
• Erstellung des passenden Speicherort ("Bucket") in InfluxDB
• Konfiguration des Importers in Node-RED, ggf. inkl. Datenbearbeitung
• Erstellung der Datenvisualisierung in Grafana

Bei Unterstützungsbedarf melde Dich gerne unter [email protected].