FileLog: Unterschied zwischen den Versionen
K (... und jetzt noch mal als Intra-Wiki Link) |
(Erläuterungen zu fhem.log und fakelog) |
||
| Zeile 1: | Zeile 1: | ||
{{Infobox Modul | {{Infobox Modul | ||
|ModPurpose=Protokollierung von Fhem-Ereignissen | |ModPurpose=Protokollierung von Fhem-Ereignissen | ||
| Zeile 21: | Zeile 20: | ||
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 und "fakelog" === | |||
Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für Fhem wird mit dem Attribut | |||
:<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. | |||
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> | |||
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}}). | |||
== Beispiele == | == Beispiele == | ||
== Links == | == Links == | ||
* . | * {{Link2Forum|Topic=40041|Message=323315|LinkText=Forenbeitrag}} zum Thema fhem.log / fakelog | ||
Version vom 17. August 2015, 08:00 Uhr
| FileLog | |
|---|---|
| Zweck / Funktion | |
| Protokollierung von Fhem-Ereignissen | |
| Allgemein | |
| Typ | Hilfsmodul |
| Details | |
| Dokumentation | EN / DE |
| Support (Forum) | Automatisierung |
| Modulname | 92_FileLog.pm |
| Ersteller | rudolfkoenig (Forum / Wiki) |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
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).
Definition
Details in der commandref (siehe Infobox).
Attribute
Über Attribute lässt sich unter anderem auch festlegen, wie die Archivierung von Logdateien durchgeführt werden soll (Archivierungsbefehl, -pfad sowie Anzahl von Archivgenerationen).
Funktionen
FileLog bietet Funktionen wie reopen, absorp und get. Details dazu sind in der commandref (siehe Infobox) zu finden.
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 Beitrag.
Globale Logdatei und "fakelog" =
Die globale Logdatei (üblicherweise als fhem.log bezeichnet) für Fhem wird mit dem Attribut
attr global logfile XXX
für das global-Objekt definiert, wobei für XXX normalerweise ./log/fhem-%Y-%m.log verwendet wird.
Um das fhem.log über das Web Interface anzeigen zu können, ist ein weiterer Eintrag in der Konfiguration erforderlich, nämlich:
define Logfile FileLog XXX fakelog
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 Forenbeitrag).
Beispiele
Links
- Forenbeitrag zum Thema fhem.log / fakelog