Komponenten > System > Dateilogger

Der Dateilogger ist eine unsichtbare Server-Komponente mit der Möglichkeit beliebige Texte, Werte, Ereignisse oder Schaltbefehle in einer Datei zu protokollieren.

Die Logdatei wird im csv-Format geschrieben. Es ist möglich die Dateiendung beliebig zu verändern. Dies wirkt sich jedoch nicht auf das Dateiformat aus.

Die Werte werden dann chronologisch untereinander eingetragen.

Das Schreiben der einzelnen Zeilen erfolgt hierbei in Abhängigkeit des Parameters 'Speicher Trigger' und dann ggf. über den Eingang 'Speicher Impuls'.

Es gibt 2 Arten der Speicherung. Steht die Eigenschaft Logging-Typ auf 'Alle Kanäle in jeder Zeile' werden bei jedem Kanalempfang bzw Trigger alle Werte in eine Zeile geschrieben. Wird die Datei in Excel geöffnet werden die Werte für jeden Kanal in einer Spalte dargestellt. Als Spaltenüberschrift steht der Kanalname. In jeder Zeile werden Nummer, Datum, Zeit und Werte gespeichert. Bei jedem Ereignis werden alle Kanäle geschrieben.

Steht die Eigenschaft Logging-Typ auf 'Eine Zeile pro Kanal' werden Nummer, Kanalname, Datum, Zeit und der Wert zeilenweise geschrieben. Es wird in jeder Zeile immer nur ein Wert angezeigt. Dieses Format eignet sich besonders für das weitere auswerten der Werte mit automatisierten Programmen.

Das schreiben in die Logdatei muss grundsätzlich über den Datenpunkt 'Aktiv' aktiviert werden.

Achtung: Werden viele Informationen in kurzen Intervallen empfangen, kann die Log-Datei sehr groß werden.

Über "Backup Impuls" wird die Logdatei archiviert. Nach triggern des "Backup Impuls" wird die Logdatei unter Pfad und Namen, der bei „Backup Dateinamen“ festgelegt wird, gespeichert. Dabei wird an den Dateinamen ein Datums- und Zeitstempel angehängt. Dieser wird unter „Backup file date format“ festgelegt.

Die eigentliche Logdatei wird dann gelöscht und beginnt neu zu schreiben.

Hinweis: Zum Aufzeichnen muss mindesten 1 Kanal angelegt, der Dateiname definiert und die Komponente 'Aktiv' geschaltet sein.

Datenpunkte der Komponente

Name	Typ	Funktion
Aktiv	Bidirektional	Über den Datenpunkt kann die Aufzeichnung aktiviert (An) und deaktiviert (Aus) werden, sowie der derzeitige Zustand ausgegeben werden.
Backup fertig	Ausgang	Wurde die Datei erfolgreich erstellt, wird hier ein "true" ausgegeben. Sind keine Daten vorhanden oder kann das Backup nicht ausgeführt werden, wird ein "false" ausgegeben.
Backup Filename	Ausgang	Gibt den Speicherpfad und Dateinamen der Backup Datei aus.
Backup Impuls	Eingang	Mit einem AN-Signal wird ein Backup erstellt. Wird ein Backup erstellt, werden die eigentliche Logdatei gelöscht.
Debugausgabe	Ausgang	Hier werden die Statusausgaben formatiert als Text ausgegeben. Der Ausgang dient zur Diagnose bei Fehlfunktion. Verbunden mit dem Eingang [Signal] des Protokollfensters werden dort die Diagnoseinformationen angezeigt.
Dynamisch	Ordner	Hier werden die in der Kanalliste definierten Kanäle angezeigt und als Datenpunkte zum Verknüpfen mit den Netzen zur Verfügung gestellt.
Gateway (Dateneingang)	Eingang	Direkte Verbindung zu einem Treiber-Gateway Datenpunkt um alle Kanäle automatisch zu loggen (zB vom Modbus Master). Hierfür muss "Eine Zeile pro Kanal" ausgewählt sein!
Letzter Logeintrag	Ausgang	Hier wird der zuletzt aufgezeichnete Wert ausgegeben
Log Dateiname ändern	Bidirektional	Über eine Zeichenkette (absoluter Speicherpfad) oder Dateiauswahl (Datei Speichern) kann der Name/Pfad der Logdatei angepasst werden.
Speicher Impuls	Eingang	Wird der Speicherimpuls getriggert so werden die aktuellen Werte in die Logdatei geschrieben. Der Logger muss dazu in jedem Fall aktiv sein.

Eigenschaften der Komponente

Name	Standard	Funktion
Kanäle	0	Aufruf der Kanalliste in der die zu speichernden Datenpunkte angelegt werden.
Logging-Typ	Alle Kanäle in jeder Zeile	Hier kann zwischen zwei Aufzeichnungsmethoden gewählt werden. 'Alle Kanäle in jeder Zeile' oder 'Eine Zeile pro Kanal'. Ein Beispiel der Darstellung ist weiter unten zu sehen.
Neue Werte in Datei anhängen	x	Ist dieser Eintrag gesetzt, werden alle eingehenden Daten untereinander in die Datei geschrieben. Ist dieser Eintrag nicht gesetzt, werden die eingehenden Werte immer in die erste Zeile geschrieben. Vorhandene Daten werden somit überschrieben.
Separator	Semikolon	Auswahl des Zeilenseparators. Möglich sind Semikolon, Komma oder Tabulator.
Datumsformat	dd.MM.yyyy	Format des Datums in der Logdatei. siehe auch Formatierungen. Es kann auch "dd.MM.yyyy HH:mm:ss" angegeben werden.
Zeitformat	HH:mm:ss	Format der Zeitangabe in der Logdatei. siehe auch Formatierungen
Culture Einstellung	German (Germany) (de-DE)	Hier wird das Land bestimmt für welches die gespeicherten Dateien bestimmt sind. In Abhängigkeit davon werden Zeit-, Datums und Werteinträge landesspezifisch gespeichert. z.B. 24 oder 12 Stundenformat; Komma oder Punkt als Trennzeichen
Aktiv		Gibt an, ob die ankommenden Daten aufgezeichnet werden sollen.
Speicher Trigger	Sofort bei Kanalempfang speichern	Ist die Einstellung 'Sofort bei Kanalempfang speichern' gewählt so werden die Werte einzeln beim Empfang in die Logdatei geschrieben. Die "Speichern bei" Einstellungen beziehen sich auf den Speicher Impuls Eingang. Bekommt der Speicherimpuls einen Wert und dieser ist identisch mit der Einstellung so werden alle Werte in die Logdatei geschrieben. Alternativ kann auch eine Speicherung alle 15/30/60 Minuten oder einmal am Tag (um Mitternacht) ausgeführt werden.
Dateiname		Hier muss der Name der Datei in welcher die Log-Meldungen gespeichert werden festgelegt werden. Durch einen Mausklick auf, "...", den Datei "Speichern unter" Dialog öffnen und einen Speicherpfad und Dateinamen angeben.
Backup Dateiname		Hier kann der Name der Backup-Datei in welcher die Log-Meldungen gespeichert werden festgelegt werden. Durch einen Mausklick auf, "...", den Datei "Speichern unter" Dialog öffnen und einen Speicherpfad und Dateinamen angeben.
Backup Datei Datumsformat	yyyyMMddHHmmss	Format der Zeitangabe, die an den Dateiname angehängt wird.
Backup zippen		Setzen, um die die Backup-Datei in eine zip-Datei zu gepackt.
Auto Backup	niemals	Es kann eine Backup-Routine für den gewählten Zeitraum festgelegt werden. Ausgeführt wird dies jeweils um 00:00Uhr.
Header loggen	x	Ist dieser Eintrag gesetzt, wird die Spaltenbezeichnung (Nummer, Datum, Uhrzeit und Kanalname) eingetragen.
Nummer loggen	x	Ist dieser Eintrag gesetzt, wird in jeder Zeile die laufende Zeilennummer geloggt.
Datum loggen	x	Ist dieser Eintrag gesetzt, dann wird in jeder Zeile das Datum geloggt.
Zeit loggen	x	Ist dieser Eintrag gesetzt, dann wird in jeder Zeile die Zeit geloggt.

Kanäle (Beispiel)

Name	Faktor	Formatstring
Leistung	1
Temperatur	0,001	#0,0 °C siehe auch Formatierungen

Name

Dieser Name des Eingangs wird als Datenpunkt-Name an der Komponente und in der Datei angezeigt.

Faktor

Bei eintreffenden Werten werden diese mit dem Faktor multipliziert. Es ist so möglich z.B. Wh in kWh umzuwandeln in dem der Faktor 0,001 eingestellt wird.

Der Faktor darf nicht auf 0 gestellt werden, da dann immer 0 protokolliert wird.

Formatstring

Standardmäßig ist kein Formatstring eingetragen. Es wird der empfangene Wert im Rohformat gespeichert.

Durch verwenden des Formatstrings ist es möglich Werte zu runden und zusätzliche Zeichen mit dem Wert zu speichern.

Beispiele:

#0,00 kWh

#0,0 °C

#0 W

Import (CSV)

Kanäle können auch mit einer CSV-Datei importiert werden. Hierbei gilt folgender Aufbau:

einzigartiger Kanalname; Faktor als Zahl; Formatstring

Beispiel: Name;2,5;FormatString

Beispiel zum Logging-Typ "Alle Kanäle in jeder Zeile"

Nr.	Date	Time	Kanal001	Kanal002
1	28.09.2021	14:35:04	1
2	28.09.2021	14:35:05	1	1
3	28.09.2021	14:35:06	0	1
4	28.09.2021	14:35:07	0	0

Beispiel zum Logging-Typ "Eine Zeile pro Kanal"

Nr.	Name	Date	Time	Value
1	Kanal001	28.09.2021	14:35:04	1
2	Kanal002	28.09.2021	14:35:05	1
3	Kanal001	28.09.2021	14:35:06	0
4	Kanal002	28.09.2021	14:35:07	0