logback.xml - Log-Ebenen konfigurieren

Die Spezifikationen für das Logging in AWI werden in der Konfigurationsdatei logback.xml definiert. Unter Verwendung dieser Datei können Sie den niedrigsten Schweregrad der Meldungen konfigurieren, die nachverfolgt werden sollen. Sie können diesen Wert ändern, sollten aber nichts anderes in der Datei ändern. Dieses Thema beschreibt kurz die Konfigurationsdatei logback.xml und wie Sie die Standardeinstellung für den Schweregrad der in das Log aufgenommenen AWI-Ereignismeldungen ändern.

Informationen über die Logging- und Tracing-Optionen in AWI, und wie Log-Daten erfasst werden, um einen Fehler zu melden, finden Sie unter Vorbereiten von Log-Dateien für die Meldung von Fehlern.

In AAKE haben Sie zusätzliche Optionen, um die Standard-Log-Ebene zu ändern. Weitere Informationen finden Sie unter Container-basierte Systeme konfigurieren.

Diese Seite beinhaltet Folgendes:

Konfiguration erforderlich?

Nein. Standardwerte sind in der gelieferten Version enthalten.

Speicherort der Datei

Sie finden die AWI-Logdateien am folgenden Speicherort:

  • Installationen mit Tomcat

    Im Ordner ...\<Anwendungsserver>\logs

  • Installationen mit dem Bundled Jetty Launcher

    AWI speichert die Logdateien im Ordner /osgi-tmp. Jede laufende Instanz erstellt einen Unterordner mit einer aufsteigenden Nummer, beginnend mit 0. Die Ordner enthalten sowohl die osgi-bezogenen Daten als auch die AWI-Logdateien.

    Ausnahme: Wenn Sie das AWI über die Kommandozeile starten und dem Befehl den Parameter -console hinzufügen, wird das Protokoll stattdessen auf die Konsole geschrieben.

    Weitere Informationen zum Starten der AWI über die Kommandozeile finden Sie unter:

logback.xml-Struktur

Diese Liste erklärt das Root-Element, in dem Sie die Log-Ebene für den LOGGER-Appender in der Datei logback.xml einstellen. Der Rest der Datei ist nicht beschrieben, da Sie ihn nicht verändern sollten.

  • <root level="log_level">

    Anfang des Root-Elements und Angabe des Attributs „level“, wo Sie die Log-Ebene definieren. Weitere Informationen finden Sie unter .

  • <appender-ref ref="LOGGER" />

    Identifiziert, dass dies das <Root>-Element für den LOGGER-Appender ist. Der LOGGER-Appender ist die Komponente, die die Logging-Ereignisse für AWI-Aktionen und -Ereignisse schreibt.

  • </root>

    Ende des Root-Elements

Beispiel:

Der folgende Code ist der Abschnitt der Datei logback.xml, in dem Sie die Root-Log-Ebene für das Logging im AWI festlegen. Hier ist die Ebene auf "INFO" eingestellt, was der Standardwert ist und für eine Produktionsumgebung geeignet ist. Sie können dies ändern, z. B. in "DEBUG", wenn Sie umfangreichere Logdateien mit mehr Details zur Fehleranalyse benötigen. Es wird empfohlen, dass Sie DEBUG nur auf Test- und Entwicklungsinstanzen verwenden.

<!-- Hier wird die Log-Ebene festgelegt. Mögliche Werte: TRACE, DEBUG, INFO, WARN, ERROR

          DEBUG wird für Test- und Entwicklungsinstanzen empfohlen.

          INFO wird für Produktionsinstanzen empfohlen.

-->

Der folgende Codeabschnitt vermeidet zu viele Logeinträge.

          <appender-ref ref="LOGGER" />

</root>

Log-Ebene wechseln

Sie haben zwei Optionen, um die Log-Ebene zu ändern:

  • Weitere Informationen finden Sie unter AWI Verwaltung: Loging

    Wichtig! Wenn Sie die Log-Ebene über die Benutzeroberfläche ändern, geht diese Änderung verloren, sobald Sie den Anwendungsserver neu starten.

  • Änderung der Datei logback.xml

Ändern der Log-Ebene in der Datei logback.xml

Die Log-Ebene ist im <root>-Element durch das Element level="[log_level]"> definiert. Das <root>-Element enthält das Element <appender-ref>, das spezifiziert, dass dieses <root>-Element den LOGGER-Appender definiert. Der LOGGER-Appender ist die Komponente, die die Logging-Ereignisse in die Logdatei schreibt.

Informationen zu den verfügbaren Log-Ebenen finden Sie unter unter AWI konfigurieren.

Wichtig! Ändern Sie keine weiteren Parameter in dieser Datei. Das Ändern anderer Parameter kann verhindern, dass CA Automic Situationen untersucht, die Fehler verursachen.

Log-Ebene wechseln

  1. Öffnen Sie die Datei logback.xml.
  2. Suchen Sie nach dem <root>-Element.

    Tipp: Sie können das <root>-Element finden, indem Sie nach ref="LOGGER" suchen. Das <root> Element steht eine Zeile darüber.

  3. Ändern Sie die Log-Ebene für den Root-Appender, indem Sie das Attribut level="[log_level]" auf die unterste Log-Ebene setzen, für die Meldungen in die Logdatei geschrieben werden sollen.
  4. Damit die Änderungen wirksam werden, müssen Sie den Anwendungsserver stoppen und neu starten.

Beispiel

Im folgenden Beispiel wird die Log-Ebene auf "DEBUG" gesetzt. Wenn Sie sie auf "INFO" ändern, werden weniger Meldungen in die Datei geschrieben, da unkritische Logmeldungen ignoriert werden.

<!-- Hier wird die Log-Ebene festgelegt. Mögliche Werte: TRACE, DEBUG, INFO, WARN, ERROR

          DEBUG wird für Test- und Entwicklungsinstanzen empfohlen.

          INFO wird für Produktionsinstanzen empfohlen.

-->

<root level="DEBUG">

          <appender-ref ref="LOGGER" />

</root>

Siehe auch: