Werken met het JSR-047-logboekvoorbeeld
In dit voorbeeld wordt de TPTP-ondersteuning voor het vastleggen van Common Base Events met behulp van JSR-047-logboek-API's beschreven die zijn geïmplementeerd in JDK 1.4.0 of hoger (java.util.logging). De gebruikers ervaren het vastleggen van Common Base Events naar de console en naar een logboekagent.
Maak het voorbeeld door Bestand > Nieuw > Voorbeeld... > JSR-047 Logging Sample te kiezen (als u dit nog niet gedaan hebt).
De inhoud van het voorbeeld bevat onder meer de Java-broncode, dependency's (exclusief java.util.logging-klassen) en het configuratiebestand dat nodig is voor het vastleggen van Common Base Events naar een JSR-047-logboek dat is geïmplementeerd in JDK 1.4.0 of hoger (java.util.logging).
JRE 1.4.0 of hoger (java.util.logging) is vereist voor het compileren en uitvoeren van dit voorbeeld.
Veronderstellingen
- Bij het starten van deze toepassing vanaf het workbenchperspectief Profilering en vastleggen in logboeken, wordt de agentcontroller-toepassing of -service geconfigureerd voor het gebruik van JRE 1.4.0 of hoger.
- De omgevingsvariabele 'java.util.logging.config.file' is ingesteld op het absolute pad en de naam van het configuratiebestand (HyadesLoggingJava14Sample.properties) van het JSR-047-logboek (java.util.logging). Bijvoorbeeld <werkgebied>/LoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties.
Starten
Om dit voorbeeld uit te voeren en automatisch aan de logboekagent te koppelen, gaat u als volgt te werk:
- Als de standaard-JRE van de workbench niet 1.4.0 of hoger is, wijzigt u het zojuist gemaakte Java-project (d.w.z. LoggingJava14Project) zodat met behulp van JRE 1.4.0 of hoger wordt gecompileerd en uitgevoerd (Project > Eigenschappen > Java-buildpad > Bibliotheken > JRE_LIB > Verwijderen > Bibliotheek toevoegen... > JRE-systeembibliotheek > Volgende > Alternatieve JRE > Geïnstalleerde JRE's... > Toevoegen... > Homedirectory van JRE > Bladeren... > [JRE 1.4.0 of hoger] > OK > OK > OK > Voltooien > OK).
- Controleer of alle compilatiefouten zijn hersteld.
- Als u een zelfstandige agentcontroller (AC) gebruikt, zorg er dan voor dat deze niet actief is (niet vereist). U kunt ook een rechtstreekse verbinding gebruiken, i.e. een beperkt aantal AC-services die bij de workbench worden meegeleverd.
- Open het perspectief Profilering en vastleggen in logboeken (Venster > Perspectief openen > Overige... > Profileren en vastleggen in logboek).
-
Voer de voorbeeldklasse uit vanaf het perspectief Profilering en vastleggen in logboeken (Uitvoeren > Profiel... > Maak een nieuwe startconfiguratie
van het type Java-toepassing > Stel de projectnaam in op de naam van het voorbeeldproject > Stel Main-klasse in op 'HyadesLoggingJava14Sample' >
Ga naar het tabblad Argumenten en stel de volgende JVM-eigenschap in:
-Djava.util.logging.config.file="<werkgebied>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties"
>Ga naar het tabblad Monitor > Deselecteer "Java-profilering" en selecteer "Agentontdekker" > Profiel).
- Na enkele seconden wordt de logboekagent automatisch gedetecteerd en gekoppeld. Selecteer de gevonden logboekagent en open de view Logboek in het perspectief Profilering en vastleggen in logboeken om de vastgelegde Common Base Event-logboekrecords te bekijken (Venster > View afbeelden > Overige... > Profilering en vastleggen in logboeken > View Logboek > OK).
- Vernieuw de view Logboek in het perspectief Profilering en vastleggen in logboeken (klik met de rechtermuisknop op de logboekagent 'HyadesLoggingJava14Sample' > Vernieuwen).
Als u dit voorbeeld wilt uitvoeren en handmatig wilt koppelen aan een logboekagent, voert u de volgende stappen uit:
- Als de standaard-JRE van de workbench niet 1.4.0 of hoger is, wijzigt u het zojuist gemaakte Java-project (d.w.z. LoggingJava14Project) zodat met behulp van JRE 1.4.0 of hoger wordt gecompileerd en uitgevoerd (Project > Eigenschappen > Java-buildpad > Bibliotheken > JRE_LIB > Verwijderen > Bibliotheek toevoegen... > JRE-systeembibliotheek > Volgende > Alternatieve JRE > Geïnstalleerde JRE's... > Toevoegen... > Homedirectory van JRE > Bladeren... > [JRE 1.4.0 of hoger] > OK > OK > OK > Voltooien > OK).
- Controleer of alle compilatiefouten zijn hersteld.
- Als u een zelfstandige agentcontroller (AC) gebruikt, zorg er dan voor dat deze niet actief is (niet vereist). U kunt ook een rechtstreekse verbinding gebruiken, i.e. een beperkt aantal AC-services die bij de workbench worden meegeleverd.
-
Voer de voorbeeldklasse uit vanaf het perspectief Java (Uitvoeren > Uitvoeren... > Maak een nieuwe startconfiguratie van het type Java-toepassing >
Main-klasse > Zoeken... > HyadesLoggingJava14Sample > OK > Ga naar het tabblad Argumenten en stel de volgende JVM-eigenschap in:
-Djava.util.logging.config.file="<werkgebied>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties"
> Uitvoeren).
- Open het perspectief Profilering en vastleggen in logboeken (Venster > Perspectief openen > Overige... > Profileren en vastleggen in logboek).
- Koppel de logboekagent 'HyadesLoggingJava14Sample' aan in het perspectief Profilering en vastleggen in logboeken (Uitvoeren > Profiel... > Toevoegen - Java-proces > Nieuw > Tabblad Host > Selecteer 'Lokale directe verbinding' als u geen zelfstandige installatie van de agentcontroller gebruikt. Geef anders een geldige hostnaam en poort op. > Tabblad Agents > Dubbelklik op de agent HyadesLoggingJava14Sample > Selecteer het tabblad Bestemming > Profileringsproject > Bladeren... > 'HyadesLoggingJava14Sample' > OK > Profile).
- Start de bewaking van de logboekagent HyadesLoggingJava14Sample. (Klik met de rechtermuisknop op de logboekagent HyadesLoggingJava14Sample en kies Bewaking starten.)
- Open de view Logboek in het perspectief Profilering en vastleggen in logboeken om de vastgelegde Common Base Event-logboekrecords te bekijken (Venster > View afbeelden > Overige... > Profilering en vastleggen in logboeken > View Logboek > OK).
- Vernieuw de view Logboek in het perspectief Profilering en vastleggen in logboeken. (Klik met de rechtermuisknop op de logboekagent HyadesLoggingJava14Sample en kies Vernieuwen.)
(C) Copyright IBM Corporation 2000, 2006.