FileLog - Versionsgeschichte

TomLee am 15. April 2025 um 18:25 Uhr

2025-04-15T18:25:51Z

← Nächstältere Version		Version vom 15. April 2025, 20:25 Uhr
Zeile 15:		Zeile 15:
	angelegt. Dabei bezeichnet		angelegt. Dabei bezeichnet
	;<name>		;<name>
	: - wie üblich - ~~das Device~~		: - wie üblich - der Devicename der Definition
	;<filename>		;<filename>
	: legt den Namen der Datei auf Dateisystemebene fest		: legt den Namen der Datei auf Dateisystemebene fest

Ph1959de: Überarbeitung zu "fakelog"; Parameter "readonly", Sonderfälle

2021-11-22T11:19:16Z

Überarbeitung zu "fakelog"; Parameter "readonly", Sonderfälle

Änderungen zeigen

Ph1959de: Überarbeitung zu "fakelog"; Parameter "readonly" separat erwähnt

2021-11-21T10:15:06Z

Überarbeitung zu "fakelog"; Parameter "readonly" separat erwähnt

← Nächstältere Version		Version vom 21. November 2021, 12:15 Uhr
Zeile 12:		Zeile 12:
	== Definition ==		== Definition ==
	Details in der {{Link2CmdRef\|Anker=FileLogdefine}}.		Details in der {{Link2CmdRef\|Anker=FileLogdefine}}.

			Seit März 2015 wird der zusätzliche (optionale) Parameter '''''readonly''''' unterstützt. Dieser kann beispielsweise verwendet werden, wenn (Log-)Dateien zur Anzeige in FHEM eingebunden werden sollen, auf die FHEM keinen Schreibzugriff hat (weil sie z.B. nicht von FHEM geschrieben werden). Siehe hierzu auch {{Link2Forum\|Topic=124167\|LinkText=dieses Forenthema}}.

	== Attribute ==		== Attribute ==
Zeile 20:		Zeile 22:
	eine Attributdefinition, die das ermöglicht.		eine Attributdefinition, die das ermöglicht.

	Dies bezieht sich aber nur auf normale FileLog-Instanzen. Falls Events aus dem globalen FHEM-Logfile ausgeschlossen werden sollen, muss man das Attribut in '''global''' angeben. (Zusammenhang siehe [[#Globale Logdatei ~~und "fakelog"\|Globale Logdatei und "fakelog"~~]])		Dies bezieht sich aber nur auf normale FileLog-Instanzen. Falls Events aus dem globalen FHEM-Logfile ausgeschlossen werden sollen, muss man das Attribut in '''global''' angeben. (Zusammenhang siehe [[#Globale Logdatei]])
	:<code>attr global ignoreRegexp .AbCd.\|.CdEf.</code>		:<code>attr global ignoreRegexp .AbCd.\|.CdEf.</code>

Zeile 28:		Zeile 30:
	Sofern eine Instanz vom Objekt [[eventTypes]] angelegt ist, bietet die Detailansicht eines FileLog eine komfortable Möglichkeit, die regulären Ausdrücke für den/die Filter zu bearbeiten. Siehe hierzu auch diesen {{Link2Forum\|Topic=12557\|Message=75436}}.		Sofern eine Instanz vom Objekt [[eventTypes]] angelegt ist, bietet die Detailansicht eines FileLog eine komfortable Möglichkeit, die regulären Ausdrücke für den/die Filter zu bearbeiten. Siehe hierzu auch diesen {{Link2Forum\|Topic=12557\|Message=75436}}.

			== Globale Logdatei ==
	== Globale Logdatei ~~und "fakelog"~~ ==
	Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für FHEM wird mit dem Attribut		Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für FHEM wird mit dem Attribut
	:<code>attr global logfile XXX</code>		:<code>attr global logfile XXX</code>
	für das ''global''-Objekt definiert, wobei für ''XXX'' normalerweise <code>./log/fhem-%Y-%m.log</code> verwendet wird.		für das ''global''-Objekt definiert, wobei für ''XXX'' normalerweise <code>./log/fhem-%Y-%m.log</code> verwendet wird.
			{{Randnotiz\|RNTyp=y\|RNText=Bis August 2021 war die Spezifikation von '''fakelog''' erforderlich bzw. möglich, um die Sonderbehandlung für diese Logdatei zu unterstützen. Mittlerweile ist das nicht mehr nötig und es wird (auch in der Beispielkonfiguration) der Wert '''Logfile''' empfohlen.}}
	Um das ''fhem.log'' über das [[FHEMWEB\|Web Interface]] anzeigen zu können, ist ein weiterer Eintrag in der [[Konfiguration]] erforderlich, nämlich:		Um das ''fhem.log'' über das [[FHEMWEB\|Web Interface]] anzeigen zu können, ist ein weiterer Eintrag in der [[Konfiguration]] erforderlich, nämlich:
	:<code>define Logfile FileLog XXX fakelog</code>		:<code>define Logfile FileLog XXX <strike>fakelog</strike> Logfile</code>
	Das ''XXX'' muss '''zwingend''' durch den gleichen Wert ersetzt werden, wie in der Definition des globalen ''logfile'' Attributs, weil anderenfalls unterschiedliche Dateien verwendet werden - mit dem Effekt, dass die über das Web Interface angezeigte Datei nicht die erwarteten Einträge enthält (Details dazu auch in diesem {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}}).		Das ''XXX'' muss '''zwingend''' durch den gleichen Wert ersetzt werden, wie in der Definition des globalen ''logfile'' Attributs, weil anderenfalls unterschiedliche Dateien verwendet werden - mit dem Effekt, dass die über das Web Interface angezeigte Datei nicht die erwarteten Einträge enthält (Details dazu auch in diesem {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}}).

	== Werte auslesen ==		== Werte auslesen ==
	Manchmal möchte man Daten aus den Logs abrufen ohne händisch in den Logfiles herumzuwühlen. Dies ist ~~insb.~~ auch dann hilfreich, wenn man ~~eigenen~~ Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.		Manchmal möchte man Daten aus den Logs abrufen, ohne händisch in den Logfiles herumzuwühlen. Dies ist insbesondere auch dann hilfreich, wenn man eigene Funktionen, Notifys oder spezielle Plots entwirft, bei denen man auf Logdaten zugreifen möchte.

	Grundsätzlich beschrieben ist dies in der {{Link2CmdRef\|Lang=de\|Anker=FileLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[DbLog#Werte_auslesen\|DbLogs]].		Grundsätzlich beschrieben ist dies in der {{Link2CmdRef\|Lang=de\|Anker=FileLog}} und unterscheidet sich minimal (aber entscheidend) von der Struktur bei [[DbLog#Werte_auslesen\|DbLogs]].
Zeile 61:		Zeile 62:
	== Links ==		== Links ==
	* {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}} zum Thema fhem.log / fakelog		* {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}} zum Thema fhem.log / fakelog
			* Forenthema zum {{Link2Forum\|Topic=124167\|LinkText="Deprecate" von ''fakelog''}}

	[[Kategorie:Logging]]		[[Kategorie:Logging]]

Jophb: Mehrere Werte und Dummy in einer Zeile loggen hinzugefügt

2020-09-27T17:56:18Z

Mehrere Werte und Dummy in einer Zeile loggen hinzugefügt

← Nächstältere Version		Version vom 27. September 2020, 19:56 Uhr
Zeile 53:		Zeile 53:
	* ...		* ...
	Weitere Beispiele kann man sich gut aus den SVG-Dateien ziehen.		Weitere Beispiele kann man sich gut aus den SVG-Dateien ziehen.

			== Mehrere Werte und Dummy in einer Zeile formatiert in Logdatei schreiben ==
			Manchmal möchte man die einzelnen Werte nicht untereinander in der Logdatei haben, sondern wie bei einer CSV-Datei in einer Zeile.

			Hierzu kann man wie im Beispiel die einzelnen Readings Kesseltemperatur, Vorlauftemperatur und Rücklauftemperatur aus One-Wire-Sensoren DS18B20 und die Außentemperatur als vierten Wert aus einem Dummy über sprintf formatieren. Wer das mit Kommas oder Semikolons getrennt haben möchte, ersetzt die Leerzeichen zwischen den einzelnen Werten durch sein Wunschtrennzeichen.<blockquote><code>attr HEIZUNG userReadings HeizDataLog {sprintf("K: %3.1f VL: %3.1f RL: %3.1f Pr: %4.1f", ReadingsVal("OWX_28_4C966XXXXXXX","temperature", 0),ReadingsVal("OWX_28_4F9XXXXXXXXX","temperature", 0),ReadingsVal("OWX_28_FFAXXXXXXXXX","temperature", 0), (Value("Heiz_Temp_Outside")))}</code></blockquote>Für die einzelnen Userreadings lassen sich auch unterschiedliche Intervalle angeben.<blockquote><code>attr HEIZUNG event-min-interval HeizDataLog:300, HeizKesselTemp:20</code></blockquote>Da im Beispiel nur Userreadings HeizDataLog geschreiben werden soll, muss es bei <regexp> dementsprechend angegeben werden.<blockquote><code># logging</code></blockquote><blockquote><code>define FileLog_Heizung FileLog ./log/Heizung/Heizung_%Y_%m.log HEIZUNG:HeizDataLog.*</code></blockquote><blockquote><code>attr FileLog_Heizung logtype text</code></blockquote><blockquote><code>attr FileLog_Heizung room LogFiles,Heizung</code></blockquote><blockquote><code>attr FileLog_Heizung group Heizung</code></blockquote>Das ergibt folgendes Ergebnis:<blockquote>2020-09-27_19:36:57 <code>HEIZUNG</code> <code>HeizDataLog</code>: K: 66.8 VL: 60.8 RL: 35.7 Out: 18.4</blockquote><blockquote>2020-09-27_19:41:58 <code>HEIZUNG</code> <code>HeizDataLog</code>: K: 60.0 VL: 56.9 RL: 34.3 Out: 18.3</blockquote><blockquote>2020-09-27_19:46:58 <code>HEIZUNG</code> <code>HeizDataLog</code>: K: 50.2 VL: 47.9 RL: 34.4 Out: 18.2</blockquote><blockquote></blockquote>

	== Links ==		== Links ==

Maista: Fhem > FHEM

2020-05-23T16:30:38Z

Fhem > FHEM

← Nächstältere Version		Version vom 23. Mai 2020, 18:30 Uhr
Zeile 6:		Zeile 6:
	\|ModOwner=rudolfkoenig ({{Link2FU\|8\|Forum}} / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])}}		\|ModOwner=rudolfkoenig ({{Link2FU\|8\|Forum}} / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])}}

	Das Modul [[FileLog]] dient zur Protokollierung von Ereignissen in ~~Fhem~~. Die Einträge werden in eine einfache Textdatei geschrieben. Zur Protokollierung in eine Datenbank kann alternativ oder auch parallel das Modul [[DbLog]] verwendet werden.		Das Modul [[FileLog]] dient zur Protokollierung von Ereignissen in FHEM. Die Einträge werden in eine einfache Textdatei geschrieben. Zur Protokollierung in eine Datenbank kann alternativ oder auch parallel das Modul [[DbLog]] verwendet werden.

	Logdateien sind die Basis für die Erstellung von Diagrammen ([[SVG]]).		Logdateien sind die Basis für die Erstellung von Diagrammen ([[SVG]]).
Zeile 30:		Zeile 30:

	== Globale Logdatei und "fakelog" ==		== Globale Logdatei und "fakelog" ==
	Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für ~~Fhem~~ wird mit dem Attribut		Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für FHEM wird mit dem Attribut
	:<code>attr global logfile XXX</code>		:<code>attr global logfile XXX</code>
	für das ''global''-Objekt definiert, wobei für ''XXX'' normalerweise <code>./log/fhem-%Y-%m.log</code> verwendet wird.		für das ''global''-Objekt definiert, wobei für ''XXX'' normalerweise <code>./log/fhem-%Y-%m.log</code> verwendet wird.

Cori: Attr ignoreRegexp für global ergänzt

2019-12-27T01:57:28Z

Attr ignoreRegexp für global ergänzt

← Nächstältere Version		Version vom 27. Dezember 2019, 03:57 Uhr
Zeile 19:		Zeile 19:
	:<code>attr <log-name> ignoreRegexp .AbCd.\|.CdEf.</code>		:<code>attr <log-name> ignoreRegexp .AbCd.\|.CdEf.</code>
	eine Attributdefinition, die das ermöglicht.		eine Attributdefinition, die das ermöglicht.

			Dies bezieht sich aber nur auf normale FileLog-Instanzen. Falls Events aus dem globalen FHEM-Logfile ausgeschlossen werden sollen, muss man das Attribut in '''global''' angeben. (Zusammenhang siehe [[#Globale Logdatei und "fakelog"\|Globale Logdatei und "fakelog"]])
			:<code>attr global ignoreRegexp .AbCd.\|.CdEf.</code>

	== Funktionen ==		== Funktionen ==

Ph1959de: Kategorie "Logging" eingefügt

2019-12-20T10:35:19Z

Kategorie "Logging" eingefügt

← Nächstältere Version		Version vom 20. Dezember 2019, 12:35 Uhr
Zeile 53:		Zeile 53:
	== Links ==		== Links ==
	* {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}} zum Thema fhem.log / fakelog		* {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}} zum Thema fhem.log / fakelog

			[[Kategorie:Logging]]

Ph1959de: Formatierung zu "ignoreRegexp" überarbeitet

2019-05-14T07:08:26Z

Formatierung zu "ignoreRegexp" überarbeitet

← Nächstältere Version		Version vom 14. Mai 2019, 09:08 Uhr
Zeile 9:		Zeile 9:

	Logdateien sind die Basis für die Erstellung von Diagrammen ([[SVG]]).		Logdateien sind die Basis für die Erstellung von Diagrammen ([[SVG]]).


	== Definition ==		== Definition ==
	Details in der {{Link2CmdRef\|Anker=FileLogdefine}}.		Details in der {{Link2CmdRef\|Anker=FileLogdefine}}.


	== Attribute ==		== Attribute ==
	Über {{Link2CmdRef\|Anker=FileLogattr\|Label=Attribute}} lässt sich unter anderem auch festlegen, wie die Archivierung von Logdateien durchgeführt werden soll (Archivierungsbefehl, -pfad sowie Anzahl von Archivgenerationen).		Über {{Link2CmdRef\|Anker=FileLogattr\|Label=Attribute}} lässt sich unter anderem auch festlegen, wie die Archivierung von Logdateien durchgeführt werden soll (Archivierungsbefehl, -pfad sowie Anzahl von Archivgenerationen).

	Wenn bestimmte Zeilen nicht in die Logdatei geschrieben werden sollen, ist das Attribut ignoreRegexp hilfreich. ~~<br>~~Wenn beispielsweise alle Zeilen, die ~~ein~~ "AbCd" oder "CdEf" ~~NICHT~~ geloggt werden sollen, dann wäre		Wenn bestimmte Zeilen '''nicht''' in die Logdatei geschrieben werden sollen, ist das Attribut ''ignoreRegexp'' hilfreich. Wenn beispielsweise alle Zeilen, die die Zeichenfolge "AbCd" oder "CdEf" enthalten '''nicht''' geloggt werden sollen, dann wäre
	<br>attr <log-name> ignoreRegexp .AbCd.\|.CdEf.<br>		:<code>attr <log-name> ignoreRegexp .AbCd.\|.CdEf.</code>
	~~das Attribut~~, das ~~dies~~ ermöglicht.		eine Attributdefinition, die das ermöglicht.

	== Funktionen ==		== Funktionen ==

Mikezulugolf: Beispiel für ein ignoreRegexp Attribut

2019-05-10T12:37:51Z

Beispiel für ein ignoreRegexp Attribut

← Nächstältere Version		Version vom 10. Mai 2019, 14:37 Uhr
Zeile 18:		Zeile 18:
	Über {{Link2CmdRef\|Anker=FileLogattr\|Label=Attribute}} lässt sich unter anderem auch festlegen, wie die Archivierung von Logdateien durchgeführt werden soll (Archivierungsbefehl, -pfad sowie Anzahl von Archivgenerationen).		Über {{Link2CmdRef\|Anker=FileLogattr\|Label=Attribute}} lässt sich unter anderem auch festlegen, wie die Archivierung von Logdateien durchgeführt werden soll (Archivierungsbefehl, -pfad sowie Anzahl von Archivgenerationen).

			Wenn bestimmte Zeilen nicht in die Logdatei geschrieben werden sollen, ist das Attribut ignoreRegexp hilfreich. <br>Wenn beispielsweise alle Zeilen, die ein "AbCd" oder "CdEf" NICHT geloggt werden sollen, dann wäre
			<br>attr <log-name> ignoreRegexp .AbCd.\|.CdEf.<br>
			das Attribut, das dies ermöglicht.

	== Funktionen ==		== Funktionen ==

Drhirn: Überschrift korrigiert

2018-06-15T09:19:08Z

Überschrift korrigiert

← Nächstältere Version		Version vom 15. Juni 2018, 11:19 Uhr
Zeile 25:		Zeile 25:


	== Globale Logdatei und "fakelog" ===		== Globale Logdatei und "fakelog" ==
	Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für Fhem wird mit dem Attribut		Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für Fhem wird mit dem Attribut
	:<code>attr global logfile XXX</code>		:<code>attr global logfile XXX</code>
Zeile 33:		Zeile 33:
	:<code>define Logfile FileLog XXX fakelog</code>		:<code>define Logfile FileLog XXX fakelog</code>
	Das ''XXX'' muss '''zwingend''' durch den gleichen Wert ersetzt werden, wie in der Definition des globalen ''logfile'' Attributs, weil anderenfalls unterschiedliche Dateien verwendet werden - mit dem Effekt, dass die über das Web Interface angezeigte Datei nicht die erwarteten Einträge enthält (Details dazu auch in diesem {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}}).		Das ''XXX'' muss '''zwingend''' durch den gleichen Wert ersetzt werden, wie in der Definition des globalen ''logfile'' Attributs, weil anderenfalls unterschiedliche Dateien verwendet werden - mit dem Effekt, dass die über das Web Interface angezeigte Datei nicht die erwarteten Einträge enthält (Details dazu auch in diesem {{Link2Forum\|Topic=40041\|Message=323315\|LinkText=Forenbeitrag}}).


	== Werte auslesen ==		== Werte auslesen ==