... |
... |
@@ -2,11
+2,11 @@ |
2 |
2 |
|
3 |
3 |
{{figure image="logging_1_de.png" width="600"}} |
4 |
4 |
Log-Nachrichten dienen der Nachvollziehbarkeit von Prozessen und ermöglichen eine Fehleranalyse. Jede Java-Klasse hat einen eigenen Logger und es ist frei konfigurierbar, welche Log-Meldungen ausgegeben werden sollen. |
5 |
|
-{{figure}} |
|
5 |
+{{/figure}} |
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 dabei jeweils die Logging Prioritäts-Stufe sowie die Ziele der Logging-Meldungen, mittels //Log-Appender//, festgelegt. Die //Log-Appender// wiederum, definieren die möglichen Ausgabekanäle (unterstützt werden Konsole und Rolling-File), sowie die Ausgabeformatierung. |
|
9 |
+Eine gültige Log-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 |
|
... |
... |
@@ -24,18
+24,19 @@ |
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 |
|
-: Definiert den konkreten Namen einer zu loggenden Klasse oder einen Java-Package-Pfad, der die 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 |
|
-: Definiert das durch den Logger zu verwendende Log-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 |
|
-: Hier werden alle definierten //Log-Appender// aufgelistet und können als Log-Ziele festgelegt werden. |
|
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 |
|