Wiki-Quellcode von Logging

Zeige letzte Bearbeiter
1 {{content/}}
2
3 {{figure image="logging_1_de.png"/}}
4
5 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.
6
7 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.
8
9 == Nutzerinteraktionsmöglichkeiten ==
10
11 * **Logger hinzufügen**
12 Fügt der Liste von //Loggern// einen Neuen hinzu. Die Bearbeitungsmaske für //Logger// wird angezeigt.
13 * **Log Appender hinzufügen**
14 Fügt der Liste von //Log-Appendern// einen Neuen hinzu. Die Bearbeitungsmaske für //Log-Appender// wird angezeigt.
15 * **Bearbeiten**
16 Führt zur Bearbeitungsmaske für den selektierten //Logger// oder //Log-Appender//.
17 * **Löschen**
18 Löscht nach erfolgreicher Bestätigung den selektierten //Logger// oder //Log-Appender//.\\
19
20 {{info}}
21 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.
22 {{/info}}
23
24 == Logger Definition ==
25
26 {{figure image="logging_2_de.png"/}}
27
28 * **Name oder Packagepfad**
29 Definiert den konkreten Namen einer zu loggenden Klasse oder einen Java-Package-Pfad, der die zu loggenden Klassen enthält.
30 * **Level**
31 Definiert das durch den Logger zu verwendende Log-Level.
32 Folgende Möglichkeiten sind gegeben: //ALL, DEBUG, INFO, WARN, ERROR, FATAL, OFF//
33 (Die Log-Level sind in absteigender Reihenfolge angegeben, das heißt, übergeordnete Log-Level schließen automatisch untergeordnete Log-Level mit ein.)
34 * **Logger-Ziele**
35 Hier werden alle definierten //Log-Appender// aufgelistet und können als Log-Ziele festgelegt werden.
36 * **Log-Scope an RootLogger vererben**
37 Diese Option erlaubt es den Log-Scope an den Root-Logger zu vererben.
38
39 == Einrichten von Log-Appendern==
40
41 {{figure image="logging_3_de.png" width="300" title="Beispiel für einen Konsolen-Log-Appender"/}}
42
43 {{figure image="logging_4_de.png" width="300" title="Beispiel für einen Rolling-File Log-Appender"/}}
44
45 * **Appendertyp**
46 Definiert den Log-Appender Typ. Unterstützt wird Console und RollingFile
47 * **Name**
48 Name für den Log-Appender, muss eindeutig sein.
49 * **Log-Level Begrenzung**
50 Legt für den Log-Appender eine Begrenzung des Log-Levels fest
51 Folgende Möglichkeiten sind gegeben: //Keine Begrenzung, DEBUG, INFO, WARN, ERROR, FATAL//
52 * **Layout_Typ**
53 Legt den Layout Typ für den Log-Appender fest. Unterstützt wird aktuell das 'Pattern' Layout.
54 Das zur Anwendung kommende Pattern wird im Feld **Layout-Pattern** angezeigt.
55
56 Die nachfolgend beschriebenen Felder sind nur bei einem //Log-Appender// vom Typ //RollingFile// zu definieren:
57
58 * **Datei**
59 Legt Dateipfad und Namen der Log-Datei fest.
60
61 {{info}}
62 Hinweis: Der Dateipfad muss im Dateisystem existieren und der Nutzer, in dessen Kontext die Applikation ausgeführt wird, muss Schreibrechte auf dieses Verzeichnis haben.
63 {{/info}}
64
65 * **Maximale Dateigröße**
66 Legt die maximal erreichbare Dateigröße fest, bevor eine neue Datei angelegt wird.
67 * **Maximale Anzahl von Backupdateien**
68 Legt die maximale erreichbare Anzahl von Backup-Logdateien fest. Wird diese Anzahl überschritten, wird die die älteste Backupdatei gelöscht.

Navigation

Copyright 2000-2024