Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt

Table of Contents


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.

Tip
titleNeue Funktion
Das Logging in die Konsole und im JSON-Format steht Ihnen ab Version 22.00.02 bzw. 22.03.00 zur Verfügung.


Excerpt

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.

Log-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=...".

    Include Page
    DAC6D:Loggereinstellungen
    DAC6D:Loggereinstellungen
    nopaneltrue

    Administration in der GTC-Oberfläche

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

    Status
    colourGreen
    titleNEU AB VERSION 22.00.03 bzw. 22.07
     Die Log-Level können nun wieder direkt in der GTC-Oberfläche angepasst werden. Dies geschieht im Bereich Stammdaten / Administration über die Schaltfläche Log-Level ändern.