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. Hierfür muss die Konfigurationsdatei log4j2-param.xml verwendet werden.
- Dazu ist zum einen der Tomcat-Parameter "-Dlog4j2.configurationFile=log4j2-param.xml" zu setzen.
- Die Auswahl eines der vier möglichen Werte CONSOLE_TEXT, CONSOLE_JSON, FILE_TEXT und FILE_JSON geschieht über den Tomcat Parameter "-DLOGGER_TARGET=...".
- Das JSON-Format kann aus den Vorgaben EcsLayout.json (Default), GcpLayout.json, GelfLayout.json, JsonLayout.json, LogstashJsonEventLayoutV1.json und StackTraceElementLayout.json ausgewählt werden. Das passiert über den Tomcat Parameter "-DLOGGER_JSON_LAYOUT=...".