Zum Inhalt springen
Elausys

HyperVisu / Dienste & Daten

Verlauf und Datenprotokollierung

InfluxDB-Einstellungen, Auswahl protokollierter Objekte und Export des Verlaufs als CSV.

elausys · 08 August 2026
Auf dieser Seite

HyperVisu speichert Zeitreihenverläufe in der eingebetteten Verlaufsdatenbank (InfluxDB). Dieses Kapitel behandelt die Verbindung, den Export von Messdaten als CSV, die Erstellung von Grafana-Panels und die Verschiebung ganzer Konfigurationstabellen von und zum Server als CSV-Dateien.

InfluxDB-Verbindung

Verlauf benötigt den InfluxDB Service. Öffnen Sie Services und prüfen Sie, ob die InfluxDB Reihe eingeschaltet ist. Wenn Sie sie jetzt einschalten, wird ein Pending Changes Banner angezeigt: Klicken Sie auf Restart Server und warten Sie, bis der Server zurückkehrt.

Die Seite InfluxDB Configuration (Services → InfluxDB → Configure) enthält eine Verbindung zu einer Verlaufsdatenbank Ihrer Wahl. Bei einer Standardinstallation können die Felder leer sein: Der Server liest und schreibt dann den Verlauf über seine eingebaute Verbindung und Sie müssen nichts ausfüllen.

FeldWas eingeben
URLDie Adresse der InfluxDB-Instanz (z.B. http://localhost:8086).
API TokenEin Token mit Lese-/Schreibberechtigung. Verwenden Sie die Augenschaltfläche, um es anzuzeigen oder auszublenden.
OrganizationDer Organisationsname in Ihrer InfluxDB-Instanz.
BucketDer Bucket, in dem Daten gespeichert sind.

Klicken Sie auf Test Connection, um die im Formular angezeigte Verbindung zu überprüfen, und klicken Sie dann auf Save, um sie zu speichern. Die Karte Database Status ändert sich von Not Tested zu Connected und zeigt die Last tested Zeit an. Test Connection benötigt alle vier Felder: Wenn die Seite leer ist, gibt es hier nichts zu testen und Sie überprüfen das Ergebnis stattdessen auf einer Trend-Seite in der App. Aus Sicherheitsgründen wird ein gespeichertes Token niemals erneut angezeigt; lassen Sie das Feld leer, um es zu behalten. Wenn der InfluxDB-Service selbst deaktiviert ist, wird eine Warnung auf der Seite angezeigt, dass Sie ihn zuerst über die Seite Services aktivieren müssen.

Nach dem Speichern einer Verbindung zeigt die Seite auch den verwendeten Speicherplatz und eine Data retention Einstellung an. Das Verkürzen des Aufbewahrungszeitraums löscht ältere Daten dauerhaft.

Desktop-Browser, InfluxDB-Konfigurationsseite mit ausgefülltem Verbindungsformular und der Karte Database Status mit Connected.

Was protokolliert wird. Protokollierung ist ein Schalter auf jedem Kommunikationsobjekt. Objekte eines Zählers und einer Trend-Analogeingang werden automatisch protokolliert; für jedes andere Objekt aktivieren Sie es:

  1. Öffnen Sie Devices, erweitern Sie das Gerät und klicken Sie auf die Schaltfläche Edit Object (das Zahnradsymbol) des Objekts.
  2. Schalten Sie Log historical values ein.
  3. Klicken Sie auf Save object. Die Objektzeile zeigt nun ein Datenbankensymbol und ein Diagrammsymbol. Keine Apply changes erforderlich.

Jeder Wert, den das Objekt empfängt, wird von diesem Moment an aufgezeichnet, unabhängig davon, ob er sich geändert hat; nichts älteres wird neu erstellt (siehe "Objekteinstellungen, Protokollierung und Benachrichtigungen"). Protokollierte Objekte speisen die Trend-Diagramme und die Zählerhistorie in der App, Grafana Dashboards, die KNX-Bus-Monitor-Diagramme und den CSV-Export unten.‍

CSV-Datenexport

Die Seite CSV Data Export konvertiert protokollierte Verläufe in eine tabellenkalkulationsfreundliche Datei. Sie hat keinen eigenen Eintrag in der Seitenleiste: Öffnen Sie Services und klicken Sie auf Export in der InfluxDB Zeile.

  1. Aktivieren Sie in Object Selection die Objekte, die Sie exportieren möchten. Sie sind nach Zimmer gruppiert; verwenden Sie das Suchfeld oder Select all. Wenn die Liste leer ist, hat noch kein Objekt Protokollierung aktiviert — aktivieren Sie es zuerst (siehe "Objekteinstellungen, Protokollierung und Benachrichtigungen").
  2. Legen Sie in Time Period Start und End fest, oder verwenden Sie eine Verknüpfung: Last 24h, Last 7 days, Last 30 days, Last year.
  3. Wählen Sie in Format das Separator: Comma, Semicolon oder Tab.
  4. Wählen Sie die Timezone, in der die Zeitstempel geschrieben sind. Das Feld öffnet sich unter Europe/Paris unabhängig von der eigenen Zeitzone des Servers, also überprüfen Sie es.
  5. Klicken Sie auf Export CSV. Die Schaltfläche zeigt Generating... an, während der Server die Datei vorbereitet.
  6. Wenn File ready angezeigt wird, klicken Sie auf Download file.

📘 Hinweis: Der Download-Link ist 1 Stunde gültig; danach generieren Sie einen neuen Export. Die Datei ist UTF-8 mit BOM, also wird sie in Excel korrekt geöffnet.

Desktop-Browser, CSV-Exportseite.

Geräteaktivitätsprotokoll

Getrennt von der Verlaufsdatenbank verwaltet der Server auch ein Pro-Geräte Aktivitätsprotokoll: jeden Befehl, der an ein Gerät gesendet wird, und jeden Statuswechsel, den es meldet, mit seiner Herkunft — der Bewohner und der Client, den er benutzte, das Szenario, die Automatisierung, die Logic-Funktion, der Plan, die Gruppe, die KNX-Brücke oder der Webhook, der es verursachte — und ob das Gerät den Befehl bestätigt hat. Es öffnet sich über die Schaltfläche Activity in jeder Gerätezeile, und seine Aufzeichnungs- und Aufbewahrungseinstellungen befinden sich auf der Seite Services → Device Activity Log. Beide werden in "Geräteaktivitätsprotokoll" beschrieben.

Häufig gestellte Fragen

Protokolliert HyperVisu jedes Objekt automatisch?

Nein. Protokollierung ist ein Schalter auf jedem Kommunikationsobjekt: Objekte eines Zählers und einer Trend-Analogeingang werden automatisch protokolliert, und Sie schalten es selbst für jedes andere Objekt ein. Der InfluxDB-Service muss ebenfalls eingeschaltet sein.

Warum ist die CSV-Exportobjektliste leer?

Noch kein Objekt hat Protokollierung aktiviert. Aktivieren Sie die Protokollierung für die Objekte, die Sie aufzeichnen und exportieren möchten.

Kann ich das CSV-Trennzeichen und die Zeitzone wählen?

Ja. Der CSV-Datenexport bietet Komma-, Semikolon- oder Tabulatortrennzeichen und eine Zeitzonenanwahl für Zeitstempel.

Wie lange ist ein generierter Download verfügbar?

Der Download-Link dauert eine Stunde. Danach generieren Sie einen neuen Export.

Wie unterscheidet sich das Geräteaktivitätsprotokoll vom Verlauf?

Der Verlauf speichert Messungen für Diagramme und Exporte. Das Aktivitätsprotokoll zeichnet Befehle und Statuswechsel, deren Herkunft und Gerätebestätigungen auf.

Weiter erkunden

Finden Sie die weiteren Anleitungen zu diesem Produkt in der Dokumentation.

Zurück zu Dienste & Daten