Änderungen von Dokument Logging
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
-
Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Inhalt
-
... ... @@ -6,55 +6,56 @@ 6 6 7 7 In diesem Bereich können Sie das zentrale Logging der Applikation beeinflussen. Änderungen am Logging können zur Laufzeit, ohne Neustart der Applikation durchgeführt werden. Somit ist es möglich für einzelne Applikationsbereiche den Log-Level vorübergehend zu ändern, um beispielsweise Log-Daten für eine Fehleranalyse zu erhalten. 8 8 9 -Eine gültige Log-Konfiguration besteht dabei immer aus einem //Logger//und einem//Log-Appender//. Im//Logger//wird dabeijeweils dieLogging Prioritäts-Stufesowie dieZielerLogging-Meldungen,mittels//Log-Appender//,festgelegt.Die //Log-Appender//wiederum,definierendiemöglichenAusgabekanäle(unterstütztwerdenKonsoleundRolling-File),sowie dieAusgabeformatierung.9 +Eine gültige Logger-Konfiguration besteht dabei immer aus einem Logger und einem Logger-Ziel. Im Logger festgelegt wird dabei der Schweregrad sowie die einzubeziehenden Log-Nachrichten. Über Logger-Ziele wird schließlich festgelegt, in welchem Format und wohin die Log-Nachrichten geschrieben werden sollen (Konsole oder Datei). 10 10 11 11 == Nutzerinteraktionsmöglichkeiten == 12 12 13 13 ; Logger hinzufügen 14 -: Fügt der Listevon//Loggern//einenNeuen hinzu. Die Bearbeitungsmaske für//Logger//wird angezeigt.15 -; Log Appender hinzufügen16 -: Fügt der Listevon//Log-Appendern//einenNeuen hinzu. Die Bearbeitungsmaske für//Log-Appender//wird angezeigt.14 +: Fügt einen neuen Logger zu den bestehenden hinzu. Die Bearbeitungsmaske für Logger wird angezeigt. 15 +; Logger-Ziel hinzufügen 16 +: Fügt ein neues Logger-Ziel zu den bestehenden hinzu. Die Bearbeitungsmaske für Logger-Ziele wird angezeigt. 17 17 ; Bearbeiten 18 -: Führt zur Bearbeitungsmaske für den selektierten //Logger//oder//Log-Appender//.18 +: Führt zur Bearbeitungsmaske für den selektierten Logger oder das Logger-Ziel. 19 19 ; Löschen 20 -: Löscht nach erfolgreicher Bestätigungden selektierten//Logger//oder//Log-Appender//.20 +: Löscht den selektierten Logger oder das Logger-Ziel. 21 21 22 22 {{info}} 23 -Hinweis: Der Root-Logger kann nicht gelöscht werden. Weiterhin können //Log-Appender//nur gelöscht werden, wenn sie von keinem//Logger//mehr verwendet werden.23 +Hinweis: Der Root-Logger kann nicht gelöscht werden. Weiterhin können Logger-Ziele nur gelöscht werden, wenn sie von keinem Logger mehr verwendet werden. 24 24 {{/info}} 25 25 26 26 == Einrichten von Loggern == 27 + 27 27 {{figure image="logging_2_de.png"}} 28 28 Ein Logger sammelt Log-Nachrichten, die ausgegeben werden sollen. Dabei kann sowohl Log-Level als auch ein Packetpfad eingestellt werden. Der Logger verwirft dann alle Log-Nachrichten aus anderen Packetpfaden oder niedrigerem Log-Level. 29 29 {{/figure}} 30 30 31 31 ; Name oder Packagepfad 32 -: Definiertden konkreten Namen einer zu loggenden Klasse oder einenJava-Package-Pfad, derdie zu loggenden Klassen enthält.33 +: Entweder ein konkreten Namen einer zu loggenden Klasse oder ein Packetpfad in Java, in dem sich die zu loggenden Klassen befinden. 33 33 ; Level 34 -: D efiniertdasdurch denLoggerzuverwendendeLog-Level. Es gibt folgende Möglichkeiten, in aufsteigender Reihenfolge des Schweregrads: //ALL//, //DEBUG//, //INFO//, //WARN//, //ERROR//, //FATAL//, OFF//. Ist ein bestimmter Schweregrad eingestellt, werden automatisch auch alle Log-Nachrichten mit höherem Schwergrad ausgegeben.35 +: Die Begrenzung für den Schweregrad der Log-Nachrichten, die ausgegeben werden. Es gibt folgende Möglichkeiten, in aufsteigender Reihenfolge des Schweregrads: //ALL//, //DEBUG//, //INFO//, //WARN//, //ERROR//, //FATAL//, OFF//. Ist ein bestimmter Schweregrad eingestellt, werden automatisch auch alle Log-Nachrichten mit höherem Schwergrad ausgegeben.// 35 35 ; Logger-Ziele 36 -: Hierwerden alledefinierten//Log-Appender//aufgelistet undkönnen alsLog-Ziele festgelegtwerden.37 +: Das Logger-Ziele, wohin die Log-Nachrichten geschrieben werden sollen. Hier werden alle angelegten Logger-Ziele aufgelistet. 37 37 ; Log-Scope an RootLogger vererben 38 -: Diese Option erlaubt es den Log-Scope an den Root-Logger zu vererben. 39 +: Diese Option erlaubt es, den Log-Scope an den Root-Logger zu vererben. Das bedeudet, dass dann eine Log-Nachricht sowohl von diesem Logger als auch vom Root-Logger ausgegeben wird. 39 39 40 40 == Einrichten von Logger-Zielen == 41 41 42 -{{figure image="logging_3_de.png" width="300" title="Beispiel für einen Konsolen-Log-Appender"}}43 +{{figure image="logging_3_de.png" width="300"}} 43 43 Ausgabe von Log-Nachrichten auf der Konsole. Hierbei werden die Log-Nachrichten als Ausschrift auf der Konsole verwendet, die beim Starten des Anwendungsservers verwendet wurde. 44 44 {{/figure}} 45 45 46 -{{figure image="logging_4_de.png" width="300" title="Beispiel für einen Rolling-File Log-Appender"}}47 +{{figure image="logging_4_de.png" width="300"}} 47 47 Ausgabe von Log-Nachrichten in einer Datei. Hierbei kann eingestellt werden, unter welchem Pfad die Datei abgelegt werden soll. Zudem kann auch die Dateigröße begrenzt werden, um den verfügbaren Speicherplatz des Servers nicht zu überschreiten. 48 48 {{/figure}} 49 49 50 -; Appendertyp51 -: Definiert denLog-AppenderTyp. Unterstützt wird //Console// und //RollingFile//51 +; Typ 52 +: Gibt die Art des Logger-Ziels an. Unterstützt wird //Console// (Ausgabe auf die Konsole) und //RollingFile// (Ausgabe in eine Datei) 52 52 ; Name 53 -: Name für d enLog-Appender,muss eindeutig sein.54 -; Log-Level 55 -: Legt für d enLog-Appender eine Begrenzung des Log-Levels fest. Es gibt folgende Möglichkeiten: //Keine Begrenzung//, //DEBUG//, //INFO//, //WARN//, //ERROR//, //FATAL//54 +: Name für das Logger-Ziel. Dieser muss eindeutig sein. Zwei Logger-Ziele dürfen nicht den gleichen Namen haben. 55 +; Log-Level-Begrenzung 56 +: Legt für das Logger-Ziel eine Begrenzung des Log-Levels fest. Es gibt folgende Möglichkeiten: //Keine Begrenzung//, //DEBUG//, //INFO//, //WARN//, //ERROR//, //FATAL// 56 56 ; Layout_Typ 57 -: Legt den Layout Typ für d enLog-Appender fest. Unterstützt wird aktuell das sogenannten Pattern-Layout. Das zur Anwendung kommende Pattern wird im Feld //Layout-Pattern// angezeigt.58 +: Legt den Layout Typ für das Logger-Ziel fest. Unterstützt wird aktuell das sogenannten Pattern-Layout. Das zur Anwendung kommende Pattern wird im Feld //Layout-Pattern// angezeigt. 58 58 59 59 Die nachfolgend beschriebenen Felder sind nur bei einem Logger-Ziel vom Typ //RollingFile// zu vorhanden: 60 60