DOIFtools

DOIFtools
Zweck / Funktion
unterstützende Funktionen zur besseren Handhabung von DOIF
Allgemein
Typ	Hilfsmodul
Details
Dokumentation	EN / DE
Support (Forum)	Automatisierung/DOIF
Modulname	98_DOIFtools.pm
Ersteller	Ellert
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

An dieser Seite wird momentan noch gearbeitet.

DOIFtools ist ein Modul zum DOIF, das Benutzern dessen Handhabung erleichtern soll.

Features / Funktionen

Das Modul DOIFtools enthält Funktionen zur Unterstützung des Benutzers im Umgang mit DOIF:

• erstellen von readingsGroup Definitionen, zur Beschriftung von Frontendelementen.
• erstellen eines Debug-Logfiles, in dem mehrere DOIF und Geräte, auf die in ihnen verwiesen wird, geloggt werden.
• erstellen von userReadings in DOIF-Geräten zur Anzeige des realen Datums bei Wochentag behafteten Timern.
• löschen von benutzerdefinierten Readings in DOIF-Definitionen über eine Mehrfachauswahl.
• erfassen statistischer Daten über Events.
• erstellen eines Statistikreports.
• Liste aller DOIF-Definitionen in probably associated with.
• Zugriff auf DOIFtools aus jeder DOIF-Definition über die Liste in probably associated with.
• Zugriff aus DOIFtools auf vorhandene DOIFtoolsLog-Logdateien.
• einblenden des Event-Monitor in der Detailansicht.

Das Modul kann hier heruntergeladen werden: Forenthread

Bedienungsanleitung

Definition

Es ist nur eine Definition je FHEM-Installation erforderlich.

Die Definition wird beim Anlegen des Gerätes mit den Namen der vorhandenen DOIF-Definitionen ergänzt und im Betrieb aktualisiert.

define DOIFtools DOIFtools

Erstellen eines Debug-Logfile

Ein FileLog-Gerät kann per Get-Befehl erstellt werden.

get DOIFtools DOIF_to_Log <Liste der gleichzeitig zu loggenden DOIF>

Bei der Fehlersuche in einem DOIF wird nur dieses DOIF ausgewählt. Wenn voneinander abhängige DOIF untersucht werden sollen, dann müssen alle abhängigen DOIF ausgewählt werden.

Es werden alle in der Definition erkannten Geräte und die wahrscheinlich verbundenen Geräte geloggt.

Die FileLog-Definition wird angezeigt und kann verwendet werden, um sie mit Raw definition zu importieren.

Wenn das Attribut executeDefinition gesetzt ist, wird der Code der Definition ausgeführt und das FileLog-Gerät erstellt.

attr DOIFtools executeDefinition 1

Wenn die Definition auch automatisch gespeichert werden soll, muss das Attribut executeSave gesetzt werden.

attr DOIFtools executeSave 1

Erfassen und Auswerten von Statistikdaten

Um eine Statistik zu erstellen, müssen zuerst Daten erfasst werden.

Zuerst sind die Modultypen festzulegen, die bei der Datenerfassunberücksichtigt werden.

set DOIFtools statisticsTYPEs <Auswahlliste

Danach wird die Datenerfassung gestartet.

set doStatistics enabled

Die Datenerfassung kann unterbrochen werden.

set doStatistics disabled

Auch eine Zeitspanne, die im Attribut disabledForIntervals gesetzt ist, unterbricht die Datenerfassung.

Die erfassten Daten können gelöscht werden.

set doStatistics deleted

Nach und während der Datenerfassung können die vorhandenen Daten ausgewertet und als Bericht dargestellt werden.

get statisticsReport

Bewertung des Ergebnisses der Datenauswertung

Hinsichtlich der Systemauslastung ist hohe Event-Rate schlechter zu bewerten als eine niedrige Rate.

Bekannte Probleme

Zum Erstellen des regulären Ausdrucks der FileLog-Definition werden keine regulären Ausdrücke der zu loggenden DOIF-Geräte ausgewertet.

Links

• DOIF
• Forenthread