Mit dem Beispiel für die Log4J-Protokollierung arbeiten
Dieses Beispiel veranschaulicht die TPTP-Unterstützung für die Protokollierung von Common Base Events mit den Protokollierungs-APIs von Apache Log4J.
Benutzer protokollieren die Common Base Events in der Konsole und in einem Protokollagenten.
Wenn Sie das Beispiel noch nicht erstellt haben, klicken Sie hierzu auf Datei >
Neu > Beispiel... > Beispiel für Protokollierung für Apache Log4J.
Der Inhalt des Beispiels umfasst den Java-Quellcode, die Abhängigkeiten und die Konfigurationsdatei, die zur Protokollierung von Common Base Events mit einer Protokollfunktion von Apache Log4J benötigt werden.
Für die Kompilierung und Ausführung dieses Beispiels wird Apache Log4J 1.2.8 (mitgeliefert) oder höher benötigt.
Annahmen
- Wenn Sie diese Anwendung in der Perspektive 'Profilermittlung und Protokollierung' der Workbench starten,
enthält entweder die Anwendungsstartkonfiguration oder die Agent Controller-Anwendung oder der Serviceklassenpfad
Apache Log4J 1.2.8 oder höher im Klassenpfad.
- Die Umgebungsvariable 'log4j.configuration' ist auf den absoluten Pfad und
Dateinamen der Konfigurationsdatei für die Apache Log4J-Protokollierung
(HyadesLoggingLog4JSample.xml) im URL-Format festgelegt. Beispiel: file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml.
- Die Apache Log4J-Dokumenttypdefinition (DTD), wie in <JAR für Apache Log4J-Protokollierung>/org/apache/log4j/xml/log4j.dtd definiert, wird in das Verzeichnis <workspace>/HyadesLoggingLog4JProject/cfg/ kopiert, damit die Datei von der Konfigurationsdatei für die Apache Log4J-Protokollierung (file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml) verwendet werden kann.
Führen Sie die folgenden Schritte aus, um dieses Beispiel auszuführen und automatisch an den Protokollagenten anzuhängen:
- Vergewissern Sie sich, dass alle Kompilierungsfehler behoben wurden.
- Wenn Sie eine Standalone-Installation von Agent Controller(AC) verwenden, stellen
Sie sicher, dass das Programm gestartet wurde (nicht erforderlich). Alternativ können
Sie eine direkte Verbindung verwenden, die eine begrenzte Anzahl von AC-Services
innerhalb der Workbench bereitstellt.
- Öffnen Sie die Perspektive 'Profilermittlung und Protokollierung' (Fenster > Perspektive öffnen > Sonstige... > Profilermittlung und Protokollierung).
-
Führen Sie die Beispielklasse in der Perspektive 'Profilermittlung und
Protokollierung' aus (Ausführen > Profil... > Neue Startkonfiguration vom Typ
Java-Anwendung erstellen > Projektname auf den Namen des Beispielprojekts festlegen >
Hauptklasse (main) auf 'HyadesLoggingLog4JSample' festlegen > zur Registerkarte 'Argumente' wechseln
und die folgende JVM-Eigenschaft festlegen: -Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml"
>zur Registerkarte 'Überwachung' wechseln > "Java-Profilermittlung abwählen"
und "Erkennungsfunktion Agenten" > Profil auswählen).
- Nach einigen Sekunden wird der Protokollagent automatisch erkannt und angehängt.
Wählen Sie den erkannten Protokollagenten aus, und öffnen Sie die Sicht 'Protokoll' in
der Perspektive 'Profilermittlung und Protokollierung', um die protokollierten Common
Base Event-Protokollsätze anzuzeigen (Fenster > Sicht anzeigen > Sonstige...
> Profilermittlung und Protokollierung > Sicht 'Protokoll' > OK).
- Aktualisieren Sie die Sicht 'Protokoll' in der Perspektive 'Profilermittlung und Protokollierung' (<mit der rechten Maustaste auf den Protokollierungsagenten 'HyadesLoggingLog4JSample' klicken> > Aktualisieren).
Alternativ können Sie die folgenden Schritte ausführen, um dieses Beispiel auszuführen und manuell an den Protokollagenten anzuhängen:
- Vergewissern Sie sich, dass alle Kompilierungsfehler behoben wurden.
- Wenn Sie eine Standalone-Installation von Agent Controller(AC) verwenden, stellen
Sie sicher, dass das Programm gestartet wurde (nicht erforderlich). Alternativ können
Sie eine direkte Verbindung verwenden, die eine begrenzte Anzahl von AC-Services
innerhalb der Workbench bereitstellt.
-
Führen Sie die Beispielklasse in der Java-Perspektive aus (Ausführen > Ausführen... > Neue Startkonfiguration vom Typ Java-Anwendung
erstellen > Hauptklasse > Suchen... > HyadesLoggingLog4JSample > OK > zur Registerkarte 'Argumente' wechseln und die folgende
JVM-Eigenschaft angeben:
-Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" >
Ausführen).
- Öffnen Sie die Perspektive 'Profilermittlung und Protokollierung' (Fenster > Perspektive öffnen > Sonstige... > Profilermittlung und Protokollierung).
- Hängen Sie an den Protokollagenten 'HyadesLoggingLog4JSample' in der Perspektive
'Profilermittlung und Protokollierung' (Ausführen > Profil... > Zuordnen -
Java-Prozess > Neu > Registerkarte 'Hosts' > verwenden Sie 'Lokale
Direktverbindung', wenn Sie keine Standalone-Installation von Agent Controller verwenden. Verwenden Sie andernfalls einen gültigen Hostnamen und Port.
> Registerkarte 'Agenten' > Auf den Agenten HyadesLoggingLog4JSample doppelklicken
> Registerkarte 'Ziel' auswählen > Profilermittlung für Projekt: >
Durchsuchen... > 'HyadesLoggingLog4JProject' > OK > Profil).
- Starten Sie die Überwachung des Protokollierungsagenten 'HyadesLoggingLog4JSample' Logging Agent (<mit der rechten Maustaste auf den Protokollierungsagenten 'HyadesLoggingLog4JSample' klicken> > Überwachung starten).
- Öffnen Sie die Sicht 'Protokoll' in der Perspektive 'Profilermittlung und Protokollierung', um die protokollierten Common Base Event-Protokollsätze anzuzeigen (Fenster > Sicht anzeigen > Sonstige... > Profilermittlung und Protokollierung > Sicht 'Protokoll' > OK).
- Aktualisieren Sie die Sicht 'Protokoll' in der Perspektive 'Profilermittlung und Protokollierung' (<mit der rechten Maustaste auf den Protokollierungsagenten 'HyadesLoggingLog4JSample' klicken> > Aktualisieren).
(C) Copyright IBM Corporation 2000, 2006.