Logging


Allgemeines und Abgrenzung

Die Log-Informationen werden im GTC mit dem Framework Log4j2 protokolliert.

Zusätzlich zu den Protokollen werden Änderungen an den Stammdaten (Changelog) in einer speziellen Tabelle dokumentiert. Die Informationen können innerhalb der Anwendung mit den entsprechenden Rechten abgerufen werden.

Logging-Konfiguration

Der Ausgabeort und das Ausgabeformat sind über Startup-Parameter des Tomcat-Server konfigurierbar. Wenn hier keine Anpassungen vorgenommen werden, erfolgt das Logging standardmäßig im Datei-Format in das Verzeichnis CATALINA_BASE/logs und folgt der Konfiguration in der Datei log4j2.xml.

Log-Verzeichnis

Mit dem Tomcat Parameter "-DLOGGER_PATH=..." kann ein anderes Log-Verzeichnis konfiguriert werden.

Format

Zusätzlich zum bisherigen Logging in Dateien kann das Logging auch in die Konsole gelenkt werden. Neben dem bisherigen Format kann alternativ im JSON-Format geloggt werden. 

  • Die Auswahl eines der vier möglichen Werte geschieht über den Tomcat Parameter "-DLOGGER_TARGET=...".
    • CONSOLE_TEXT
    • CONSOLE_JSON
    • FILE_TEXT 
    • FILE_JSON 
  • Das JSON-Format kann aus den folgenden Vorgaben ausgewählt werden und wird über den Tomcat Parameter "-DLOGGER_JSON_LAYOUT=..." gesteuert.
    Eine Erläuterung der verschiedenen Layouts kann in der log4j2-Dokumentation unter dem Punkt "Event Templates" eingesehen werden.
    • EcsLayout.json (Default)
    • GcpLayout.json
    • GelfLayout.json
    • JsonLayout.json
    • LogstashJsonEventLayoutV1.json
    • StackTraceElementLayout.json

Administration in der GTC-Oberfläche

Im GTC kann der System-Administrator die Logdateien im Dialog Stammdaten / Administration im Reiter Logdateien einsehen.

Die Log-Level können direkt in der GTC-Oberfläche angepasst werden. Dies geschieht im Bereich Stammdaten / Administration über die Schaltfläche Log-Level ändern.