TelegramLogger (Telegramm Logger)
Dieser Baustein gehört zum Paket „Administrative (Administrativ).“
Paket-Preis: 22,50€
Kurzbeschreibung
Dieser Baustein dient dazu, bestimmte Werteänderungen zu protokollieren. Sie kann genutzt werden, um bei Aktivierung automatisch festgelegte Datenpunkte zu überwachen und deren Werte zeitlich sortiert zu speichern. Es werden sowohl die ersten als auch die letzten festgelegten Werte erfasst. Dies ist besonders hilfreich, um den zeitlichen Verlauf und die Entwicklung von Daten zu analysieren – etwa in einem Smart-Home-System. Eine zentrale Ausgabe listet die erfassten Werte samt Zeitstempel und Auslöser der Veränderung auf.
Besonderheit
Funktionale Flexibilität:
- Die Anzahl der Eingänge kann flexibel gewählt werden (1 bis 30).
- Es ist einstellbar, wie viele der ersten und letzten Änderungen gespeichert werden (jeweils 1 bis 100).
- Die Eingänge sind dynamisch wählbar und können verschiedene Datentypen haben.
Fehlerbehandlung:
- Ein interner Mechanismus fängt Fehler ab und gibt diese als Teil der Ausgabe aus.
- Bei auftretenden Problemen wird das genaue Datum und die Art des Fehlers mitgeliefert.
Grenzen und Validierungen:
- Es sind feste Minimal- und Maximalwerte für alle zählbaren Eingänge definiert:
- Anzahl der Eingänge: mindestens 1, maximal 30.
- Anzahl der ersten und letzten protokollierten Werte: jeweils mindestens 1, maximal 100.
- Es sind feste Minimal- und Maximalwerte für alle zählbaren Eingänge definiert:
Dieser Baustein verfolgt das Ziel, Werteänderungen in einer Smart-Home- oder Automatisierungsumgebung zu erfassen und übersichtlich auszugeben. Die Funktion beginnt erst mit der Protokollierung, wenn sie aktiv geschaltet wurde. Es wird überwacht, wie viele Werte protokolliert werden sollen und welche davon zu Beginn (erste Werte) und welche später (letzte Werte) gespeichert werden.
Sobald eine Veränderung bei den überwachten Eingängen erkannt wird, beginnt die Methode, die Werte mit einem Zeitstempel und dem Namen des auslösenden Eingangs aufzuzeichnen. Die Protokollierung erfolgt dabei getrennt nach den ersten und letzten Änderungen, was besonders für zeitlich orientierte Fehleranalysen oder Überwachungen hilfreich ist.
Die Anzahl der gespeicherten Anfangs- und Endwerte ist individuell einstellbar, jedoch durch feste Grenzen geschützt, damit das System nicht überlastet wird. Die protokollierten Daten enthalten zusätzlich zu den Werten auch Informationen darüber, wann und durch welchen Eingang sie ausgelöst wurden.
Die Ausgabe besteht aus einem vollständigen Log-Text, in dem die „ersten“ und „letzten“ Einträge strukturiert dargestellt werden. Sollte ein Fehler während der Protokollierung auftreten, wird dieser mit Datum und Fehlerbeschreibung ebenfalls im Log ausgegeben.
- Activate (bool):
- Schaltet die Protokollierung ein oder aus.
- Wenn nicht aktiv, wird keine Aufzeichnung vorgenommen.
- NumberOfInputsToLog (bool):
- Legt fest, wie viele Eingänge überwacht werden.
- Min: 1 | Max: 30
- InputsToLog (list<any>):
- Die zu überwachenden Eingänge.
- Können unterschiedliche Datentypen enthalten.
- Änderungen an diesen Eingängen lösen die Protokollierung aus.
- NumberOfFirstInputs (int):
- Bestimmt, wie viele der ersten Änderungen gespeichert werden sollen.
- Min: 1 | Max: 100
- NumberOfLastInputs (int):
- Bestimmt, wie viele der letzten Änderungen gespeichert werden sollen.
- Min: 1 | Max: 100
- LogExecute (string):
- Gibt das vollständige Protokoll aus.
- Enthält: Zeitstempel, auslösender Eingang, Wert, Fehlertexte (falls aufgetreten).
Beispiel 1 – Fehlersuche bei Systemausfällen:
Bei sporadischen Ausfällen im KNX-System soll nachverfolgt werden, welche Telegramme kurz vor und nach dem Fehler gesendet wurden.
- Eingabe:
Activate:true- NumberOfInputsToLog:
10 - InputsToLog: Verschiedene KNX-Komponenten (Schalter, Dimmer, etc.)
- NumberOfFirstInputs: 10
- NumberOfLastInputs: 10
- Ausgabe:
LogExecute:- Die ersten 10 Telegramme nach Systemstart werden protokolliert.
- Die letzten 10 Telegramme unmittelbar vor einem möglichen Fehler werden ebenfalls gespeichert.
- Fehlerprotokolle mit Zeitangabe bei Ausnahmefällen.
Sie können bis zu 30 Eingänge gleichzeitig überwachen.
Es werden nur die letzten 100 berücksichtigt. Werte darüber hinaus werden automatisch verworfen.
Ja, die Funktion unterstützt verschiedenste Datentypen in der Eingabeliste.
- Version 3.0.10
- First Release
Baustein-Support
Wenn Sie X1-Logik-Baustein-Support benötigen, senden Sie uns bitte zusätzlich den Log (LogExecute, welcher als Ausgang des Bausteins ausgegeben wird) und eine detaillierte Beschreibung des Problems zu!
