Mit dem Beispiel für die JSR-047-Protokollierung arbeiten

Dieses Beispiel veranschaulicht die TPTP-Unterstützung für die Protokollierung von Common Base Events mit den Protokollierungs-APIs von JSR-047, die in JDK 1.4.0 oder höher implementiert wurden (z. B. java.util.logging). 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 JSR-047.

Der Inhalt des Beispiels umfasst den Java-Quellcode, die Abhängigkeiten (einschließlich der Klassen "java.util.logging") und die Konfigurationsdatei, die zur Protokollierung von Common Base Events mit einer JSR-047-Protokollfunktion erforderlich sind, die in JDK 1.4.0 oder höher implementiert ist (java.util.logging).

Für die Kompilierung und Ausführung dieses Beispiels wird JRE 1.4.0 oder höher (also java.util.logging) benötigt.

Annahmen

  1. Wenn Sie diese Anwendung in der Perspektive 'Profilermittlung und Protokollierung' der Workbench starten, ist die Agent Controller-Anwendung oder der Service so konfiguriert, dass JRE 1.4.0 oder höher verwendet wird.
  2. Die Umgebungsvariable 'java.util.logging.config.file' ist auf den absoluten Pfad- und Dateinamen der Konfigurationsdatei (HyadesLoggingJava14Sample.properties) für die JSR-047-Protokollierung (java.util.logging) festgelegt. Beispiel: <workspace>/LoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties.

Startvorgang

Führen Sie die folgenden Schritte aus, um dieses Beispiel auszuführen und automatisch an den Protokollagenten anzuhängen:
  1. Wenn die Standard-JRE der Workbench nicht Version 1.4.0 oder höher aufweist, ändern Sie das neu erstellte Java-Projekt (LoggingJava14Project) so ab, dass es mit JRE 1.4.0 oder höher kompiliert und ausgeführt wird (Projekt > Eigenschaften > Java-Erstellungspfad > Bibliotheken > JRE_LIB > Entfernen > Bibliothek hinzufügen ... > JRE-Systembibliothek > Weiter > Alternative JRE > Installierte JREs... > Hinzufügen...> JRE-Ausgangsverzeichnis > Durchsuchen... > [JRE 1.4.0 oder höher] > OK > OK > OK > Fertig stellen > OK).
  2. Vergewissern Sie sich, dass alle Kompilierungsfehler behoben wurden.
  3. 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.
  4. Öffnen Sie die Perspektive 'Profilermittlung und Protokollierung' (Fenster > Perspektive öffnen > Sonstige... > Profilermittlung und Protokollierung).
  5. 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 'HyadesLoggingJava14Sample' festlegen > zur Registerkarte 'Argumente' wechseln und die folgende JVM-Eigenschaft festlegen: -Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" >zur Registerkarte 'Überwachung' wechseln > "Java-Profilermittlung abwählen" und "Erkennungsfunktion Agenten" > Profil auswählen).
  6. 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).
  7. Aktualisieren Sie die Sicht 'Protokoll' in der Perspektive 'Profilermittlung und Protokollierung' (mit der rechten Maustaste auf den Protokollierungsagenten 'HyadesLoggingJava14Sample' klicken > Aktualisieren).

Alternativ können Sie die folgenden Schritte ausführen, um dieses Beispiel auszuführen und manuell an den Protokollagenten anzuhängen:

  1. Wenn die Standard-JRE der Workbench nicht Version 1.4.0 oder höher aufweist, ändern Sie das neu erstellte Java-Projekt (LoggingJava14Project) so ab, dass es mit JRE 1.4.0 oder höher kompiliert und ausgeführt wird (Projekt > Eigenschaften > Java-Erstellungspfad > Bibliotheken > JRE_LIB > Entfernen > Bibliothek hinzufügen ... > JRE-Systembibliothek > Weiter > Alternative JRE > Installierte JREs... > Hinzufügen...> JRE-Ausgangsverzeichnis > Durchsuchen... > [JRE 1.4.0 oder höher] > OK > OK > OK > Fertig stellen > OK).
  2. Vergewissern Sie sich, dass alle Kompilierungsfehler behoben wurden.
  3. 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.
  4. Führen Sie die Beispielklasse in der Java-Perspektive aus (Ausführen > Ausführen... > Neue Startkonfiguration vom Typ Java-Anwendung erstellen > Hauptklasse > Suchen... > HyadesLoggingJava14Sample > OK > zur Registerkarte 'Argumente' wechseln und die folgende JVM-Eigenschaft angeben: -Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" > Ausführen).
  5. Öffnen Sie die Perspektive 'Profilermittlung und Protokollierung' (Fenster > Perspektive öffnen > Sonstige... > Profilermittlung und Protokollierung).
  6. Hängen Sie an den Protokollagenten 'HyadesLoggingJava14Sample' 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 HyadesLoggingJava14Sample doppelklicken > Registerkarte 'Ziel' auswählen > Profilermittlung für Projekt: > Durchsuchen... > 'HyadesLoggingJava14Sample' > OK > Profil).
  7. Starten Sie die Überwachung des Protokollierungsagenten 'HyadesLoggingJava14Sample' Logging Agent (<mit der rechten Maustaste auf den Protokollierungsagenten 'HyadesLoggingJava14Sample' klicken> > Überwachung starten).
  8. Ö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).
  9. Aktualisieren Sie die Sicht 'Protokoll' in der Perspektive 'Profilermittlung und Protokollierung' (<mit der rechten Maustaste auf den Protokollierungsagenten 'HyadesLoggingJava14Sample' klicken> > Aktualisieren).