Anpassen des Logging-Verhaltens

DocuScan Support Aktualisiert von DocuScan Support

StorageRobot wird mit einer Standardkonfiguration für die Protokollierung der Ereignisse die während der Programmausführung auftreten ausgeliefert.

Die Protokollierung basiert auf der Log4net Bibliothek der Apache Foundation. Weitere ausführliche Information erhalten Sie hier: https://logging.apache.org/log4net/release/manual/introduction.html

In den meisten Fällen möchte man jedoch nur einfache Anpassungen wie die Anzahl der Logfiles oder die maximale Größe der Logfiles beeinflussen.

Durch die manuelle Änderung der Konfigurationsdatei kann es dazu kommen, dass eine einzelne Konfiguration oder die gesamte Anwendung nicht mehr oder falsch funktionieren. Erstellen Sie daher vor jeder Änderung eine Sicherungskopie Ihrer Konfigurationsdatei und achten Sie unbedingt auf die exakte Schreibweise von Parametern und Werten. Die Änderung der Konfigurationsdatei erfolgt auf eigene Gefahr.

Dazu haben wir Ihnen den folgenden Leitfaden zusammengestellt:

  1. Beenden Sie sämtliche laufenden StorageRobot Prozesse und die Administration. Deaktivieren Sie zudem ggf. geplante Aufgaben und stoppen den Observer Service
  2. Öffnen Sie die Datei log4net.config, welche sich im Installationsverzeichnis befindet mit einem Editor wie dem Notepad++
  3. Nehmen Sie die erforderlichen Anpassungen vor. Siehe Informationen unten
  4. Speichern Sie die Datei
  5. Aktivieren Sie ggf. deaktivierte geplante Aufgaben und starten den Observer falls dieser zuvor gestoppt wurde.

 

Änderung der maximalen Größe und Anzahl von Logfiles

Suchen Sie folgenden Abschnitt in der Datei:

<maxSizeRollBackups value="5" />
<maximumFileSize value="1MB" />

Ändern Sie das Attribut value des Elements maxSizeRollBackups z.B. von "5" auf "10". Dadurch erhöht sich die Zahl der gleichzeitig vorhandenen Logdateien pro Konfiguration auf 10.

Ändern Sie das Attribut value des Elements maximumFileSize von "1MB" auf "5MB" um die Größe einer Logdatei auf 5 Megabyte zu erhöhen.

Änderung des Loglevels 

Standardmäßig wird immer im DEBUG Modus protokolliert. Um deutlich weniger Informationen zu protokollieren kann dieser Modus auf INFO geändert werden. Suchen Sie dazu folgenden Abschnitt in der Datei:

<root>
  <level value="DEBUG"/>
  <appender-ref ref="RollingFileAppender"/>
  <appender-ref ref="ColoredConsoleAppender" />
</root>

Ändern Sie im Element level den Wert des Attributs value auf "INFO"

Achtung: Möglicherweise sind die Informationen im Logfile nach dieser Änderung nicht mehr ausreichend um Rückschlüsse auf die Ursache von möglichen Fehlern zu ziehen.

Loglevel

Es stehen die folgenden Loglevel zur Verfügung. Dabei schließt das jeweils folgende Loglevel sämtliche vorherige ein. Beispiel: Wenn Sie WARN einstellen, dann werden auch alle Meldungen mit dem Typ ERROR protokolliert.

ERROR

Alle aufgetretenen Fehler.

WARN

Warnmeldungen weisen auf mögliche Probleme hin. Werden in unseren Programmen jedoch nur sehr selten verwendet.

INFO

Informative Meldungen die einen groben Ablauf der Anwendung darstellen

DEBUG

Alle Meldungen. Erforderlich für Logdateien die an den Support gesendet werden.

Siehe auch

Speicherort der Logdateien/Logfiles

Wie waren wir?

Entfernen von Steuerzeichen aus Barcode Werten

Barcodes, Dateieigenschaften und OCR Werte anhand von Zeilenumbruch oder Tabulator trennen

Support