Welche Werte werden vom LxLogger erfasst?

Generell werden die Werte aller Geräte die auch in der Loxone- Config angelegt wurden von unserem Loxone Datenlogger erfasst und gespeichert. Aufgrund der Funktionalität kann es sein, dass neu angelegte Geräte dennoch nicht in der Visualisierung erscheinen. Dazu aber in den folgenden Abschnitten mehr.

Die Funktionsweise unseres Datenloggers

Wird der LxLogger für das Datenlogging gestartet, lädt sich dieser die aktuelle Konfiguration (LoxApp3.json) vom Loxone Miniserver herunter. Diese Datei enthält alle konfigurierten Räume, Kategorien und Controls deiner Loxone Installation.

Diese Informationen werden dann im Datenlogger zwischengespeichert und für die Benennung der sich ändernden Werte herangezogen. Somit kannst du innerhalb der Visualisierung ganz bequem über den Namen auf die Werte zurückgreifen und musst nicht über eine kryptische Zeichenfolge, nämlich die UUID eines Controls, deine Statistikwerte identifizieren.

Beim Verbinden liefert der Miniserver den aktuellen Wert jedes States. Diesen Startzustand schreibt der LxLogger mit dem Zeitpunkt des Verbindens in die Datenbank, beim Start und nach jedem erneuten Verbindungsaufbau. Werte, die sich selten ändern, etwa ein Sollwert, ein Betriebsmodus oder ein Zählerstand, stehen dadurch sofort zur Verfügung.

Die Lösung

Dies hat zur Folge, das neu angelegte Geräte/Controls innerhalb der Loxone- Config nicht sofort vom Datenlogger erkannt werden. Um also auch die Statistiken neuer Geräte in die Visualisierung zu bekommen ist ein Neustart des LxLogger von Nöten. Speichere also zuerst dein Loxone- Config Projekt ab, lade dieses in den Miniserver hoch und starte den LxLogger neu.

Danach sollten dann auch die Werte der neuen Geräte in der Visualisierung angezeigt werden und für die Auswertung innerhalb von Grafana verwendet werden können.

Linux

Um den Datenlogger neu zu starten genügt der folgende Befehl:

sudo systemctl restart lxlogger

Windows

Gehe hierzu in die Aufgabenplanung, wähle den LxLogger Dienst aus und starte diesen neu.

Text-Werte

Manche States liefern Text statt einer Zahl, etwa eine Statusmeldung. Diese Werte schreibt der LxLogger in das Feld text. Das Feld value enthält in jedem Measurement immer eine Zahl. In Grafana zeigst du einen Text-Wert z. B. so an:

SELECT last("text") FROM "<Measurement>" WHERE $timeFilter

Werte außerhalb von Bausteinen

Der Miniserver schickt auch Werte, die zu keinem Baustein in der Loxone Config gehören. Der LxLogger benennt sie so:

Unterbausteine mit eigener UUID, etwa ein Zähler in einem Energiemanager, als <Baustein>/<Unterbaustein>, mit Raum und Kategorie des Bausteins.
Ausgänge von Statistiken unter dem Namen des Bausteins, mit dem Namen des Ausgangs als State.
Betriebsmodi als modes, z. B. modes (Urlaub).
Globale Werte als globalStates, z. B. globalStates (sunrise).
Wetterdaten als weatherServer, siehe Wetterdaten.
Einträge aus Autopilot, Mitteilungszentrale und Musikserver unter ihrem Namen, z. B. Systemstatus (changed).

Bis auf die Unterbausteine haben diese Werte weder Raum noch Kategorie.

Wetterdaten

Nutzt dein Miniserver den Wetterdienst der Loxone Cloud (Cloud Weather), schreibt der LxLogger das aktuelle Wetter und die Vorhersage. Ohne eigenes Namens-Template heißen die Measurements:

weatherServer (actual) – das aktuelle Wetter
weatherServer (forecast) – die Vorhersage im Stundenraster

Für jede Stunde gibt es einen Punkt mit dem Zeitstempel dieser Stunde. Er enthält die folgenden Felder:

Feld	Inhalt
`temperature`	Temperatur
`perceived_temperature`	Gefühlte Temperatur
`dew_point`	Taupunkt
`relative_humidity`	Relative Luftfeuchtigkeit
`precipitation`	Niederschlag
`wind_speed`	Windgeschwindigkeit
`wind_direction`	Windrichtung
`barometric_pressure`	Luftdruck
`solar_radiation`	Sonneneinstrahlung
`weather_type`	Wettertyp als Zahl
`weather_text`	Wettertyp als Text in der Sprache des Miniservers, z. B. „leichter Regen“

Die Vorhersage wird bei jedem Update überschrieben. Grafana zeigt also immer die aktuelle Vorhersage für die nächsten Tage. Die ersten Wetterdaten erscheinen mit dem nächsten Update des Miniservers, spätestens eine Stunde nach dem Start.

Per MQTT kommt das aktuelle Wetter als ein Objekt und die Vorhersage als eine Nachricht mit der Liste entries, jeweils mit units und formats.

Ladehistorie der Wallbox

Eine Wallbox Gen. 2 führt ihre letzten Ladevorgänge in der Historie (history). Der LxLogger schreibt jeden Ladevorgang als eigenen Punkt, mit dem Zeitpunkt des Absteckens als Zeitstempel.

Feld / Tag	Inhalt
`energy`	Geladene Energie in kWh
`price`	Kosten des Ladevorgangs
`power`	Ladeleistung in kW
`connect`	Zeitpunkt des Ansteckens
`start`	Beginn des Ladens
`duration`	Dauer in Sekunden
`wallbox` (Tag)	Name der Wallbox
`user` (Tag)	Benutzer, falls gesetzt
`ext_authority` (Tag)	Externe Freigabe, falls gesetzt

Der Miniserver schickt die Historie bei jeder Änderung komplett. Gleiche Ladevorgänge überschreiben sich dabei, es entstehen also keine doppelten Punkte. Beim ersten Start kommen alle Ladevorgänge mit, die die Wallbox noch gespeichert hat. Energie und Kosten pro Tag und Wallbox zeigst du in Grafana z. B. so an:

SELECT sum("energy"), sum("price") FROM /entries/
  WHERE time > now() - 365d GROUP BY time(1d), "wallbox"

Per MQTT kommt die Historie als eine Nachricht mit der Liste entries.

Was nicht geschrieben wird

Schaltuhren: Eine Schaltuhr schickt ihren Zeitplan, also Konfiguration und keine Messwerte. Den schreibt der LxLogger nicht. Was die Schaltuhr gerade schaltet, steht in ihrem eigenen State.
Ungültige Zahlen: Werte wie NaN oder inf überspringt der LxLogger und schreibt eine Warnung ins Log.