Die Logging-Systemeinstellungen findet man als Karte „Logging“ in den Systemeinstellungen über die Navigation „Hauptmenü / Systemressourcen / Systemeinstellungen“.

Hier lassen sich das Log-Level und die Löschfrist für die Logdateien des Portals vorgeben.

Voraussetzung

Als Voraussetzung dafür muss jedoch die Portal-Applikation mit dem Schalter -Dlogging.config=<log4j2-Konfigurationsdatei> gestartet und die zugelieferte log4j2-Konfigurationsdatei verwendet werden. Diese muss durch die Systemadministration nur bezüglich des Log-Verzeichnisses angepasst werden, Details hierzu finden sich im Installationshandbuch.

Beim Speichern der Logging-Systemeinstellungen werden die Werte des Log-Levels und der Löschfrist in die log4j2-Konfigurationsdatei eingetragen. Ist die log4j-Konfiguration nicht zentral über den Schalter gesetzt, lässt sich hier keine Systemeinstellung vornehmen und es erscheint als Information:

„Hinweis: Die zentrale Logging-Konfiguration wurde von der Administration nicht aktiviert.“

Auswahl- und Eingabefelder

Als erste Systemeinstellung lässt sich das Log-Level der Applikation steuern.

Es gibt folgende Levels in der Reihenfolge abnehmender Detailliertheit:

• TRACE
• DEBUG
• INFO
• WARN
• ERROR
• FATAL
• OFF

Jedes Log-Level beinhaltet neben den eigenen außerdem die Logausgaben aller jeweils darunterliegenden Levels. D.h. beim Log-Level „TRACE“ sind die Logdateien am detailliertesten und enthalten die Ausgaben sämtlicher Log-Levels, bei „FATAL“ werden nur noch Ausgaben mit dem Level „FATAL“ geloggt und bei „OFF“ erfolgt gar kein Logging.

Für den Betrieb des Portals ist das Log-Level „INFO“ ausreichend. Für die Entwicklung wird zu Analysezwecken meistens das Log-Level „DEBUG“ verwendet.

Die zweite Systemeinstellung betrifft die Frist, nach der Logdateien automatisch gelöscht werden.

Die Applikation erzeugt jeden Tag eine neue Logdatei. Die alten Logdateien werden mit dem aktuellen Datum versehen und als ZIP-Datei gepackt. Diese ZIP-Dateien werden nach der hier eingestellten Frist automatisch gelöscht. Der Standardwert beträgt 60 Tage.