Plot-Abriss vermeiden: Unterschied zwischen den Versionen

Aus FHEMWiki
Zur Navigation springen Zur Suche springen
(→‎Beispiele mit DOIF: Syntax (siehe commandref.html); Substantivierung groß)
(Doppel ;; fehlt, etwas überarbeitet)
Zeile 1: Zeile 1:
== Motivation ==
== Motivation ==
Bei Nutzung des Attributs event-on-change werden Log-Einträge nur bei Werteänderung geschrieben. Dies führt
Bei Nutzung des Attributs <code>event-on-change</code> werden Log-Einträge nur bei Werteänderung geschrieben. Dies führt
a) zum Abriss der Logs zum Ende des alten und zum Beginn des neuen Tages
# zum Abriss der Logs zum Ende des alten und zum Beginn des neuen Tages
b) zu inadäquat langen Pausen zwischen Logeinträgen, z.B. für actuator, der zB in den Wintermonaten bei Anwesenheit durchgängig 100%, bei Abwesenheit durchgängig 0% betragen kann. Der Wechsel zwischen diesen Werten wird mit langen Flanken dargestellt.
# zu inadäquat langen Pausen zwischen Logeinträgen, z.B. für <code>actuator</code>, der z.B. in den Wintermonaten bei Anwesenheit durchgängig 100%, bei Abwesenheit durchgängig 0% betragen kann. Der Wechsel zwischen diesen Werten wird mit langen Flanken dargestellt.


== Funktionsweise ==
== Funktionsweise ==
Die Routine addLog fügt zu definierten Zeitpunkten Einträge im Log hinzu. Dadurch sollen die o.g. Effekte vermieden werden. Zusätzliche Einträge sind mit dem Anhang "&lt;&lt; addLog" gekennzeichnet.
Aus diesem Grund wurde die Routine <code>addLog</code> erstellt (siehe [[#Implementierung|Implementierung]]).
Der Aufruf erfolgt sinnvollerweise aus einem at. Üblich ist der Aufruf für alle Geräte bzw. readings, für die "event-on-change" gesetzt ist.
Sie fügt zu definierten Zeitpunkten Einträge im Log hinzu.
Dadurch sollen die o.g. Effekte vermieden werden.
Zusätzliche Einträge sind mit dem Anhang <code><< addLog</code> gekennzeichnet.
Der Aufruf erfolgt sinnvollerweise aus einem <code>at</code> oder einem <code>DOIF</code>.
Üblich ist der Aufruf für alle Geräte bzw. readings, für die <code>event-on-change</code> gesetzt ist.


Die Routine hat zwei Aufrufparameter:
Die Routine hat zwei Aufrufparameter:
 
<source lang=text>
<nowiki>addLog(&lt;devicename&gt;, &lt;reading&gt;)</nowiki>
addLog(<devicename>, <reading>)
</source>


== Beispiele aus fhem.cfg ==
== Beispiele aus fhem.cfg ==
<nowiki>### jede Stunde einen Eintrag für FHT actuator
<source lang=text>
define a_actuator at +*01:00 {addLog(&quot;ez_FHT&quot;,&quot;actuator&quot;)}
### jede Stunde einen Eintrag für FHT actuator
attr a_actuator room 99_System</nowiki>
define a_actuator at +*01:00 {addLog("ez_FHT","actuator")}
attr a_actuator room 99_System
</source>


addLog für mehrere devices in einem "Makro" zusammenfassen:
<code>addLog</code> für mehrere <code>devices</code> in einem "Makro" zusammenfassen:
<source lang=text>
define addLog notify addLog {addLog("ez_Aussensensor","state");;\
    addLog("ez_FHT","actuator");;\
    addLog("ez_FHT","measured-temp");;\
    addLog("MunichWeather","humidity");;\
    addLog("MunichWeather","pressure");;\
    addLog("MunichWeather","temperature");;\
    addLog("MunichWeather","wind_chill");;}
attr addLog room 99_System
</source>


<nowiki>define addLog notify addLog {addLog(&quot;ez_Aussensensor&quot;,&quot;state&quot;);;addLog(&quot;ez_FHT&quot;,&quot;actuator&quot;);;addLog(&quot;ez_FHT&quot;,&quot;measured-temp&quot;);;addLog(&quot;MunichWeather&quot;,&quot;humidity&quot;);;addLog(&quot;MunichWeather&quot;,&quot;pressure&quot;);;addLog(&quot;MunichWeather&quot;,&quot;temperature&quot;);;addLog(&quot;MunichWeather&quot;,&quot;wind_chill&quot;);;}
<source lang=text>
attr addLog room 99_System</nowiki>
### Hier ist ein trigger des o.g. notify verwendet, um nicht in beiden at-defines alle Aufrufe listen zu müssen.
 
<nowiki>### Hier ist ein trigger des o.g. notify verwendet, um nicht in beiden at-defines alle Aufrufe listen zu müssen.
define a_midnight1 at *23:59 trigger addLog
define a_midnight1 at *23:59 trigger addLog
attr a_midnight1 room 99_System
attr a_midnight1 room 99_System
define a_midnight2 at *00:01 trigger addLog
define a_midnight2 at *00:01 trigger addLog
attr a_midnight2 room 99_System
attr a_midnight2 room 99_System
# Alternativ können auch die Einzelaufrufe direkt im at erfolgen, zB
# Alternativ können auch die Einzelaufrufe direkt im at erfolgen, z.B.
# define a_midnight_before at *23:59 {addLog(&quot;device&quot;,&quot;reading&quot;)}</nowiki>
define a_midnight_before at *23:59 {addLog("device","reading")}
 
</source>


==Beispiele mit DOIF ==
==Beispiele mit DOIF ==
Zeile 49: Zeile 64:


== Log-Beispiele ==
== Log-Beispiele ==
<nowiki>2012-11-04_23:46:28 ez_Aussensensor T: 9.4 H: 78.5
<source lang=text>
2012-11-04_23:59:00 ez_Aussensensor T: 9.4 H: 78.5  &lt;&lt; addLog
2012-11-04_23:46:28 ez_Aussensensor T: 9.4 H: 78.5
2012-11-04_23:59:00 ez_FHT actuator: 0%  &lt;&lt; addLog
2012-11-04_23:59:00 ez_Aussensensor T: 9.4 H: 78.5  << addLog
2012-11-04_23:59:00 ez_FHT measured-temp: 17.4  &lt;&lt; addLog
2012-11-04_23:59:00 ez_FHT actuator: 0%  << addLog
2012-11-05_00:01:00 ez_Aussensensor T: 9.4 H: 78.5  &lt;&lt; addLog
2012-11-04_23:59:00 ez_FHT measured-temp: 17.4  << addLog
2012-11-05_00:01:00 ez_FHT actuator: 0%  &lt;&lt; addLog
2012-11-05_00:01:00 ez_Aussensensor T: 9.4 H: 78.5  << addLog
2012-11-05_00:01:00 ez_FHT measured-temp: 17.4  &lt;&lt; addLog
2012-11-05_00:01:00 ez_FHT actuator: 0%  << addLog
2012-11-05_00:24:31 ez_FHT actuator: 0%  &lt;&lt; addLog
2012-11-05_00:01:00 ez_FHT measured-temp: 17.4  << addLog
2012-11-05_00:24:31 ez_FHT actuator: 0%  << addLog
2012-11-05_00:42:32 ez_Aussensensor T: 9.1 H: 78.1
2012-11-05_00:42:32 ez_Aussensensor T: 9.1 H: 78.1
2012-11-05_16:02:59 ez_Aussensensor T: 10.3 H: 65.9
2012-11-05_16:02:59 ez_Aussensensor T: 10.3 H: 65.9
2012-11-05_16:05:56 ez_Aussensensor T: 10.2 H: 66.3
2012-11-05_16:05:56 ez_Aussensensor T: 10.2 H: 66.3
2012-11-05_16:21:47 ez_Aussensensor T: 10.2 H: 66.3  &lt;&lt; addLog
2012-11-05_16:21:47 ez_Aussensensor T: 10.2 H: 66.3  << addLog
2012-11-05_16:21:48 ez_FHT actuator: 100%  &lt;&lt; addLog
2012-11-05_16:21:48 ez_FHT actuator: 100%  << addLog
2012-11-05_16:21:48 ez_FHT measured-temp: 18.5  &lt;&lt; addLog
2012-11-05_16:21:48 ez_FHT measured-temp: 18.5  << addLog
2012-11-05_16:30:26 ez_FHT measured-temp: 18.7
2012-11-05_16:30:26 ez_FHT measured-temp: 18.7
2012-11-05_16:44:18 ez_Aussensensor T: 9.9 H: 65.8</nowiki>
2012-11-05_16:44:18 ez_Aussensensor T: 9.9 H: 65.8
</source>
 
== Nebeneffekte ==
== Nebeneffekte ==
addLog verwendet die Funktion trigger. Für fhem ist das gleichwertig mit dem Eintreffen eines Funktelegramms. Es werden also ggf. alle notifies ausgeführt, die für das relevante Gerät abzuarbeiten sind.
<code>addLog</code> verwendet die Funktion <code>trigger</code>.
Dies ist wohl zu bedenken, bevor man addLog verwendet.
Für fhem ist das gleichwertig mit dem Eintreffen eines Ereignisses.
Es werden also ggf. alle <code>notifies</code> ausgeführt, die für das relevante Gerät abzuarbeiten sind.
Dies ist wohl zu bedenken, bevor man <code>addLog</code> verwendet.


== Bekannte Probleme ==
== Bekannte Probleme ==
Das Modul dewpoint fügt dem state eines device den zusatz "D: xx" hinzu. Timing-abhängig kann dies zu "verwurschtelten" Darstellungen führen. Die Verwendung von addLog in Verbindung mit dewpoint ist daher nicht empfohlen.
Das Modul [[dewpoint]] fügt dem <code>state</code> eines <code>device</code> den zusatz <code>D: xx</code> hinzu.
Abhängig vom Timing kann dies zu "verwurschtelten" Darstellungen führen.
Die Verwendung von <code>addLog</code> in Verbindung mit <code>dewpoint</code> ist daher nicht empfohlen.


== Implementierung ==
== Implementierung ==
Die Routine wird in die lokale Programmdatei integriert, z.B. 99_myUtils.pm, siehe [[99 myUtils anlegen]].
Die Routine wird in eine lokale Programmdatei integriert, z.B. <code>99_myUtils.pm</code> (siehe [[99 myUtils anlegen]]).
Nach dem hineinkopieren bitte daran denken, ein reload 99_myUtils.pm durchzuführen.
Wird die Funktion dort mit einem externen Editor eingefügt, muss anschließend <code>reload 99_myUtils.pm</code> ausgeführt werden.
Auf Fehlermeldungen im fhem.log achten.
Auf Fehlermeldungen im fhem.log achten.
 
<source lang=perl>
<nowiki>#### Log-abriss vermeiden
#### Log-abriss vermeiden
# called by
# called by
# define addLog notify addLog {addLog(&quot;ez_Aussensensor&quot;,&quot;state&quot;);addLog(&quot;ez_FHT&quot;,&quot;actuator&quot;);\
# define addLog notify addLog {addLog("ez_Aussensensor","state");;\
#               addLog(&quot;MunichWeather&quot;,&quot;humidity&quot;);addLog(&quot;MunichWeather&quot;,&quot;pressure&quot;);\
#            addLog("ez_FHT","actuator");;\
#               addLog(&quot;MunichWeather&quot;,&quot;temperature&quot;);addLog(&quot;MunichWeather&quot;,&quot;wind_chill&quot;);}
#           addLog("MunichWeather","humidity");;\
#            addLog("MunichWeather","pressure");;\
#           addLog("MunichWeather","temperature");;\
#            addLog("MunichWeather","wind_chill");;}
# define a_midnight1 at *23:59 trigger addLog
# define a_midnight1 at *23:59 trigger addLog
# define a_midnight2 at *00:01 trigger addLog
# define a_midnight2 at *00:01 trigger addLog
Zeile 93: Zeile 118:
     fhem &quot;trigger $logdevice $reading: $logentry  &lt;&lt; addLog&quot;;
     fhem &quot;trigger $logdevice $reading: $logentry  &lt;&lt; addLog&quot;;
   }
   }
}</nowiki>
}
</source>


[[Kategorie:Code Snippets]]
[[Kategorie:Code Snippets]]

Version vom 28. Januar 2017, 13:51 Uhr

Motivation

Bei Nutzung des Attributs event-on-change werden Log-Einträge nur bei Werteänderung geschrieben. Dies führt

  1. zum Abriss der Logs zum Ende des alten und zum Beginn des neuen Tages
  2. zu inadäquat langen Pausen zwischen Logeinträgen, z.B. für actuator, der z.B. in den Wintermonaten bei Anwesenheit durchgängig 100%, bei Abwesenheit durchgängig 0% betragen kann. Der Wechsel zwischen diesen Werten wird mit langen Flanken dargestellt.

Funktionsweise

Aus diesem Grund wurde die Routine addLog erstellt (siehe Implementierung). Sie fügt zu definierten Zeitpunkten Einträge im Log hinzu. Dadurch sollen die o.g. Effekte vermieden werden. Zusätzliche Einträge sind mit dem Anhang << addLog gekennzeichnet. Der Aufruf erfolgt sinnvollerweise aus einem at oder einem DOIF. Üblich ist der Aufruf für alle Geräte bzw. readings, für die event-on-change gesetzt ist.

Die Routine hat zwei Aufrufparameter:

addLog(<devicename>, <reading>)

Beispiele aus fhem.cfg

### jede Stunde einen Eintrag für FHT actuator
define a_actuator at +*01:00 {addLog("ez_FHT","actuator")}
attr a_actuator room 99_System

addLog für mehrere devices in einem "Makro" zusammenfassen:

define addLog notify addLog {addLog("ez_Aussensensor","state");;\
    addLog("ez_FHT","actuator");;\
    addLog("ez_FHT","measured-temp");;\
    addLog("MunichWeather","humidity");;\
    addLog("MunichWeather","pressure");;\
    addLog("MunichWeather","temperature");;\
    addLog("MunichWeather","wind_chill");;}
attr addLog room 99_System
### Hier ist ein trigger des o.g. notify verwendet, um nicht in beiden at-defines alle Aufrufe listen zu müssen.
define a_midnight1 at *23:59 trigger addLog
attr a_midnight1 room 99_System
define a_midnight2 at *00:01 trigger addLog
attr a_midnight2 room 99_System
# Alternativ können auch die Einzelaufrufe direkt im at erfolgen, z.B.
define a_midnight_before at *23:59 {addLog("device","reading")}

Beispiele mit DOIF

Seitdem es DOIF gibt, lässt sich das Ganze auch etwas anders umsetzen:

define DF_addLogDaily DOIF ([23:59] or [00:01]) ({addLog("ez_FHT", "actuator")})
attr DF_addLogDaily room 99_System
attr DF_addLogDaily do always

Da mit diesem Aufruf aber die Problematik nur nach unten verschoben wird (Zoom auf Stunde oder Vierteltag), ist folgendes möglich:

define DF_addLogHourly DOIF ([:59] or [:01]) ({addLog("ez_FHT", "actuator")})
attr DF_addLogHourly room 99_System
attr DF_addLogHourly do always

Das Ganze lässt sich auch noch auf minütlich runterbrechen, erzeugt dadurch ggf. eine große Menge Logeinträge. Dies sollte man stets bedenken.

Log-Beispiele

2012-11-04_23:46:28 ez_Aussensensor T: 9.4 H: 78.5
2012-11-04_23:59:00 ez_Aussensensor T: 9.4 H: 78.5   << addLog
2012-11-04_23:59:00 ez_FHT actuator: 0%   << addLog
2012-11-04_23:59:00 ez_FHT measured-temp: 17.4   << addLog
2012-11-05_00:01:00 ez_Aussensensor T: 9.4 H: 78.5   << addLog
2012-11-05_00:01:00 ez_FHT actuator: 0%   << addLog
2012-11-05_00:01:00 ez_FHT measured-temp: 17.4   << addLog
2012-11-05_00:24:31 ez_FHT actuator: 0%   << addLog
2012-11-05_00:42:32 ez_Aussensensor T: 9.1 H: 78.1
2012-11-05_16:02:59 ez_Aussensensor T: 10.3 H: 65.9
2012-11-05_16:05:56 ez_Aussensensor T: 10.2 H: 66.3
2012-11-05_16:21:47 ez_Aussensensor T: 10.2 H: 66.3   << addLog
2012-11-05_16:21:48 ez_FHT actuator: 100%   << addLog
2012-11-05_16:21:48 ez_FHT measured-temp: 18.5   << addLog
2012-11-05_16:30:26 ez_FHT measured-temp: 18.7
2012-11-05_16:44:18 ez_Aussensensor T: 9.9 H: 65.8

Nebeneffekte

addLog verwendet die Funktion trigger. Für fhem ist das gleichwertig mit dem Eintreffen eines Ereignisses. Es werden also ggf. alle notifies ausgeführt, die für das relevante Gerät abzuarbeiten sind. Dies ist wohl zu bedenken, bevor man addLog verwendet.

Bekannte Probleme

Das Modul dewpoint fügt dem state eines device den zusatz D: xx hinzu. Abhängig vom Timing kann dies zu "verwurschtelten" Darstellungen führen. Die Verwendung von addLog in Verbindung mit dewpoint ist daher nicht empfohlen.

Implementierung

Die Routine wird in eine lokale Programmdatei integriert, z.B. 99_myUtils.pm (siehe 99 myUtils anlegen). Wird die Funktion dort mit einem externen Editor eingefügt, muss anschließend reload 99_myUtils.pm ausgeführt werden. Auf Fehlermeldungen im fhem.log achten.

#### Log-abriss vermeiden
# called by
# define addLog notify addLog {addLog("ez_Aussensensor","state");;\
#            addLog("ez_FHT","actuator");;\
#            addLog("MunichWeather","humidity");;\
#            addLog("MunichWeather","pressure");;\
#            addLog("MunichWeather","temperature");;\
#            addLog("MunichWeather","wind_chill");;}
# define a_midnight1 at *23:59 trigger addLog
# define a_midnight2 at *00:01 trigger addLog
sub
addLog($$) {
  my ($logdevice, $reading) = @_; # device and reading to be used
  my $logentry = ReadingsVal($logdevice,$reading,&quot;addLog: invalid reading&quot;);
  if ($reading =~ m,state,i) {
    fhem &quot;trigger $logdevice $logentry   &lt;&lt; addLog&quot;;
  } else {
    fhem &quot;trigger $logdevice $reading: $logentry   &lt;&lt; addLog&quot;;
  }
}