Loggen am Beispiel von log4j ETIS 2005

Transkript

1 Loggen am Beispiel von log4j ETIS 2005

2 Motivation Logging Hauptbestandteile Logger Appender Layout Konfiguration Gliederung Log4j vs. Sun s Logging API Zusammenfassung 2

3 Motivation - Aufgaben Logging Low level debug-methode Innere Abläufe der Anwendung (über Ausgaben) verfolgen Information über Zustand des Programms Programm läuft Programm fehlerhaft Information über wichtige Ereignisse welche Methoden, in welcher Reihenfolge aufgerufen Probleme aufgetreten Suche logischer Fehler Kontrolle von Variablenwerten 3

4 Motivation - Alternativen Logging Debugger: + umfangreiche Konfigurations- und Kontrollmöglichkeiten nicht immer verfügbar (verteilte Anwendungen) Loggen oft schneller Debugging transient - Logging persistent System.out.print(...) + steht immer zur Verfügung, leicht anzuwenden Übersichtlichkeitsprobleme nur Standardausgabe Ausgaben nicht zur Laufzeit konfigurierbar und nicht einfach abschaltbar (nur löschbar oder extra Konstrukte programmieren) 4

5 Motivation - Log4j I Selber Programmieren einer Logging API belastet eigentliches Projekt zusätzlich Loggen in vielen Projekten benötigt (in Entwicklung + produktiver Umgebung) Ł vorhandene Logging-API nutzen, z.b. de facto Standard log4j, um Log-Statements zu nutzen entstand aus Logging-API des EU-Projektes Semper Apache Jakarta Projekt, Open Source einsetzbar ab JDK 1.1 einfacher Einstieg in API bei sehr komplexen Möglichkeiten 5

6 Motivation Log4j II Evtl. Probleme beim Loggen: Anwendung verlangsamt Informationen schwer finden Ziele Log4J: Wenig Performanceverluste durch Logging klassifizierbare Informationen (z.b. Ausschalten bestimmter Loginformationen) Anwendung zur Laufzeit konfigurierbar Loginformationen zur Laufzeit an- und ausschaltbar frei definierbare Ausgabeformate/-orte der Log- Meldungen 6

7 Logger (Wird geloggt?) Appender (Wohin?) Layouts (Format?) Hauptbestandteile 7

8 Kernkomponente Klasse Logger Klassenname als Loggername ist Konvention Bereitstellung als statische Variable in Anwendung private static Logger logger = Logger.getLogger( test.sample ); Besitzt Methoden, um Meldungen (auf verschiedenen Stufen) wie: logger.debug( irgendwas ); logger.info ( irgendwas ); auszugeben vordefinierte Level erweiterbar 8

9 Vordefinierte Log-Level Normale Log-Level DEBUG feingranulare Informationsereignisse, zum Debuggen INFO informierende Nachrichten, groben Ablauf aufzeigen WARN potentiell nachteilige Situationen ERROR Fehler, Anwendung läuft evtl. weiter FATAL ernster Fehler, meist Abbruch der Anwendung Spezielle Log-Level ALL niedrigste Priorität, Loggen anschalten OFF höchste Priorität, Loggen abschalten ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF 9

10 Log-Level I Logger haben bestimmtes Level z.b. Logger hat Level WARN (z.b. in Konfigurationsdatei festgelegt) Log-Methoden haben bestimmtes Level z.b. c.info(...): Log-Meldung auf Level INFO Level des Loggers entscheidet, ob Log-Meldung geschrieben wird Schreiben, wenn Level der Log-Methode höher oder gleich dem Level seines Loggers z.b. Logger hat Level WARN + Methode ist c.info(), da INFO < WARN: c.info ignoriert 10

11 Log-Level II Logger bilden durch. getrennte hierarchische Baum- Struktur z.b. java.sql.connection Ein Root-Logger weitere Logger ein Vorfahr und evtl. mehrere Nachfahren java Vorfahr von java.sql Level der Logger vererbbar, wenn nicht explizit gesetzt z.b. java: INFO, sql: keine Zuweisung sql = INFO z.b. java: INFO, sql: WARN sql = WARN Wenn Klassenname = Loggername Logging für einzelne Klasse oder packages ein- und ausschaltbar 11

12 Logging - Performance Log-Statements bleiben i.d.r. im Code Versteckte Kosten für Parameterkonstruktion logger.debug( irgendwas ); if-statement als Performance-Wrapper if (logger.isdebugenabled() == true){ logger.debug( irgendwas + ichbinteuer()); } 12

13 Appender jedem Logger sind ein oder mehrere Appender zuordenbar Appender in Loggerhierarchie vererbt Appender legt fest, wohin geloggt wird z.b. Console, File, JDBC, SMTP... (können um eigene erweitert werden) Vererbungskonzept Appender: Kinder des Loggers erben automatisch alle Appender des Vaters z.b. Vater hat Konsole-Appender, Kind hat File- Appender Kind schreibt auf Konsole und in File Logger-Attribut additivity = false unterbindet Vererbung 13

14 Layout Appender wird bei Konfiguration Layout-Pattern übergeben beschreibt, wie Ausgabe aussieht optische Aufbesserung verbesserte Fehlersuche Z.B. PatternLayout, HTMLLayout, XMLLayout (können um eigene erweitert werden) Pattern-Layout am flexibelsten, C printf-funktion nachempfunden 14

15 Konfiguration Ziel: Logging-Verhalten zur Laufzeit konfigurieren in Konfigurationsdatei Verhalten einstellen für Anbindung an Konfigurationsdatei sorgen durch einmaligen Aufruf von configure() BasicConfigurator ohne Konfigurationsdatei, belegt System mit sinnvollen Startwerten PropertyConfigurator bezieht Daten aus Properties-Datei DOMConfigurator ähnlich P. Dateiformat XML 15

16 Properties-Datei (log4j.properties) #obersten Logger auf DEBUG setzen, Appender: A1 log4j.rootlogger = DEBUG, A1 #A1 ist ConsoleAppender Ausgabe auf Console log4j.appender.a1 = org.apache.log4j.consoleappender #A1 verwendet ein Pattern Layout log4j.appender.a1.layout = org.apache.log4j.patternlayout log4j.appender.a1.layout.conversionpattern = [%d / %p / %c ] - %m%n%n 16

17 Log4J vs. Sun s Log API Ähnlichkeiten in Namensgebung (Klassen: Logger, Level) Konzept hierarchischer Logger ähnlich Log4J viele Appender, Sun 3 Handler Log4J Konfiguration in XML + Properties-Datei, Sun nur Properties-Datei Log4J ab JDK 1.1, Sun erst ab 1.4 Log4J gereift und robust, performanter, umfangreicher Log4J Portierungen für PHP, C/C++, Python,.NET 17

18 Zusammenfassung open source gute Performance, Funktionalität, Handhabung gute Integrierbarkeit in eigene Anwendungen umfangreiche Erweiterungsmöglichkeiten in existierenden Systemen verwendet (JBoss) GUI-basierte Tools vorhanden (Chainsaw, LogFactor5) momentan besser als Sun s Logging API, Wechsel allerdings recht unproblematisch 18

19 Quellen Wille, S., Go To Java Server Pages, Addison-Wesley, München, 2001 Evertz, M.: Logger Dir Einen, Javamagazin, 11/2002, S Eickstädt, D., Reuhl, T., Java mit Open Source-Tools, Markt+Technik, München,