Logging

Einfach erklärt: Was ist Logging?

Logging bedeutet, dass Docuflair alle wichtigen Ereignisse und Aktionen in Textdateien protokolliert. Diese Protokolle helfen bei der Fehlersuche und beim Support. Je nach Einstellung werden mehr oder weniger Details aufgezeichnet.

Bei der Arbeit mit Docuflair werden im Hintergrund bestimmte Daten in Log-Dateien gespeichert. Normalerweise sind diese Informationen vor allem für den technischen Support erforderlich, jedoch sind diese Dateien auch für Sie ersichtlich.

Unter diesem Pfad: C:\Docuflair\instances\default\log finden Sie die verschiedenen Log-Dateien. Jeder Dienst wird in einer eigenen Log-Datei aufgezeichnet.

Aufbau

Die erste Spalte einer Zeile beinhaltet das Datum, danach folgt die exakte Uhrzeit mit tausendstel Sekunde, dann einer von sechs verschiedenen Log-Level und am Ende der Zeile steht schließlich eine Nachricht, welche aussagt, was passiert ist.

Anpassungen

Die Dauer, für wie lange Log-Dateien gespeichert werden sollen, lässt sich im Docuflair Manager in den Erweiterten Einstellungen der Standardeinstellungen angeben.

Um anzupassen, wie viel aufgezeichnet werden soll, benötigen Sie die Log-Level Utility von Docuflair. Diese ist im Startmenü als LogLevel [default] auffindbar.

Achtung

Je mehr mitprotokolliert wird, desto langsamer läuft Docuflair!

Log-Level Utility

Unter Application können Sie einen beliebigen Dienst von Docuflair auswählen und bei Level den gewünschten Log-Level wählen. Die Log-Level sind hier von oben nach unten sortiert, das höchste Level protokolliert auch am meisten Daten. Es werden auch die Daten aller darunterliegenden Level mitgespeichert.

Reihenfolge der Log-Level: + Verbose + Debug + Information + Warning + Error + Fatal

Möchten Sie die Log-Level wieder auf die Standardeinstellung zurücksetzen, klicken Sie auf Options und wählen Reset.

Außerdem können Sie in den Options auf Max. Logging klicken. Das hat zur Folge, dass alle Dienste mit der höchsten Stufe eingestellt werden.

Schließen Sie die Log-Level Utility, nachdem Einstellungen verändert wurden, erhalten Sie eine Information. Diese besagt, dass Sie den Windows Service "Docuflair Background Services [default]" neu starten sollen, um die Änderungen zu übernehmen. Auch ein Neustart des Servers übernimmt die Änderungen.

Falls Sie einen Server für das Logging verwenden möchten, können Sie in der Log-Level Utility unter Log-Server die IP-Adresse und Portnummer eines Servers angeben. Seq eignet sich hierfür zum Beispiel.

Mehr Informationen zu Seq finden Sie hier.

Service Neustart

Damit Änderungen übernommen werden, müssen Sie vom Startmenü Dienste ausführen. In der Auflistung suchen Sie dann nach: "Docuflair Background Services [default]", drücken rechtsklick darauf und wählen Neu starten. Sollten Sie eine Konfiguration mit dem "Internet Information Server" verwenden, muss dieser ebenfalls neu gestartet werden.

Log-Dateien löschen

Um Log-Dateien zu löschen, welche noch in Benutzung sind, müssen Sie den "Docuflair Background Services [default]" beenden. Die Log-Dateien werden dann nicht mehr vom Betriebssystem geschützt und können im Explorer gelöscht werden. Damit es zu keinen Fehlern bei der Benutzung von Docuflair kommt, sollten Sie den beendeten Service nach dem Löschen der Dateien erneut starten.