[patch] DbLog: Modifiers in defaultMinInterval / DbLogExclude / DbLogInclude

[RalfRog]

Spricht etwas dagegen die Logikmatrix mit in die Commandref aufzunehmen?
...

Auch nicht schlecht.


attr <device> DbLogInclude Regex[:MinInterval][:force],[Regex[:MinInterval][:force]], ...

Mit dem Attribut DbLogInclude werden die Readings definiert, die in der Datenbank gespeichert werden sollen. Die Definition der zu speichernden Readings erfolgt über einen regulären Ausdruck und alle Readings die mit dem regulären Ausdruck matchen werden in der Datenbank gespeichert.

Der optionale Zusatz <MinInterval> gibt an, dass ein Wert dann gespeichert wird wenn mindestens <MinInterval> Sekunden seit der letzten Speicherung vergangen sind.

Unabhängig vom Ablauf des Intervalls wird das Reading gespeichert wenn sich der Wert des Readings verändert hat. Mit dem optionalen Zusatz "force" kann erzwungen werden das angegebene Intervall <MinInterval> einzuhalten auch wenn sich der Wert des Readings seit der letzten Speicherung verändert hat.

Hinweis1: Attribut DbLogSelectionMode muss entsprechend gesetzt sein (siehe dort). Mit Attribut defaultMinInterval kann ein Default vorgegeben werden.
Hinweis2: Wird DbLog genutzt, wird in allen Devices das Attribut DbLogInclude und  DbLogExclude propagiert.

Dann vielleicht noch die Matrix
Analog dazu DbLogExclude

[DS_Starter]

Die kleine Matrix ist für das Verständnis durchaus hilfreich, allerdings wird außerhalb des Intervalls immer gespeichert, ob sich der Wert geändert hat oder nicht.
Ich fasse alles nochmal zusammen.

[DS_Starter]

Hier die Zusammenfassung:


attr <device> DbLogInclude Regex[:MinInterval][:force],[Regex[:MinInterval][:force]], ...

Mit dem Attribut DbLogInclude werden die Readings definiert, die in der Datenbank gespeichert werden sollen.
Die Definition der zu speichernden Readings erfolgt über einen regulären Ausdruck und alle Readings die mit dem regulären
Ausdruck matchen werden in der Datenbank gespeichert.

Der optionale Zusatz <MinInterval> gibt an, dass ein Wert dann gespeichert wird wenn mindestens <MinInterval> Sekunden
seit der letzten Speicherung vergangen sind.

Unabhängig vom Ablauf des Intervalls wird das Reading gespeichert wenn sich der Wert des Readings verändert hat. Mit dem
optionalen Modifier "force" kann erzwungen werden das angegebene Intervall <MinInterval> einzuhalten auch wenn sich der Wert
des Readings seit der letzten Speicherung verändert hat.

| Modifier |              innerhalb Intervall             | außerhalb Intervall |
|             | Wert gleich           | Wert geändert   |                             |
|----------+--------------------+-------------------+----------------------|
| <none> | ignorieren            | speichern          | speichern              |
| force     | ignorieren             | ignorieren         | speichern              |

Hinweise:
Das Attribut DbLogInclude wird in allen Devices propagiert wenn DbLog verwendet wird.
Das Attribut DbLogSelectionMode muss muss entsprechend gesetzt sein um DbLogInclude zu aktivieren.
Mit dem Attribut defaultMinInterval kann ein Default vorgegeben werden.


-------------------

Für DbLogExclude  passe ich es dann sinngemäß auch an. Die Verweise auf andere Attribute werden mit einem Link unterlegt sodass man dorthin verzweigen kann.

[RalfRog]

Von mir den Daumen hoch 

Die Verweise auf andere Attribute werden mit einem Link unterlegt sodass man dorthin verzweigen kann.

Das wichtige DbLogSelectionMode steht ja glücklicherweise direkt darüber

[kaarsten]

Top, das finde ich jetzt schon viel verständlicher. Danke fürs Zusammenfassen aller Vorschläge!

[DS_Starter]

Ist zwar länger geworden als ich es vermutet hätte, aber wenn es nun verständlich ist übernehme ich den Text gerne. 
Denke dass ich die ComRef in DbLog bis zum WE überarbeitet habe.

Danke euch 

Das wichtige DbLogSelectionMode steht ja glücklicherweise direkt darüber

Naja, es gibt ja auch die Direkthilfe bei der Auswahl der Attribute im FHEMWEB. Dann ist der Link dennoch hilfreich.

[DS_Starter]

Ist eingecheckt und morgen früh im Regelupdate.

LG