Arbejd med eksempel på JSR-047-log
Dette eksempel demonstrerer TPTP-understøttelsen af logning af Common Base Events vha. JSR log-API'erne. Brugerne lærer, hvordan de registrerer Common Base Events på kontrollen og i en logagent.
Hvis du ikke allerede har gjort det, kan du oprette eksemplet via Fil >
Ny > Eksempel... > JSR-047-logeksempel.
Indholdet af eksemplet omfatter den Java-kildekode, de afhængigheder (eksklusive java.util.logging-klasser) og den konfigurationsfil, der er nødvendige for at registrere Common Base Events i en JSR-047-logger, implementeret i JDK 1.4.0 eller nyere (dvs. java.util.logging).
JRE 1.4.0 eller nyere (dvs. java.util.logging) kræves for at kompilere og udføre dette eksempel.
Forudsætninger
- Når du starter dette program fra perspektivet Profilering og logning på arbejdsbænken, konfigureres Agent Controller-programmet eller -serviceprogrammet til at bruge JRE 1.4.0 eller nyere.
- Miljøvariablen "java.util.logging.config.file" er angivet til JSR-047-loggens (dvs. java.util.logging) konfigurationsfils (HyadesLoggingJava14Sample.properties) absolutte sti og navn. Eksempel: <arbejdsområde>/LoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties.
Start
Udfør følgende trin for at udføre eksemplet og automatisk oprette tilknytning til logagenten:
- Hvis arbejdsbænkens standard-JRE ikke er 1.4.0 eller nyere, skal du revidere det nye Java-projekt (dvs. LoggingJava14Project), så det kompileres og udføres vha. JRE 1.4.0 eller nyere (Projekt > Egenskaber > Java-byggesti > Biblioteker > JRE_LIB > Fjern > Tilføj bibliotek... > JRE-systembibliotek > Næste > Alternativ JRE > Installerede JRE'er... > Tilføj... > JRE-hjemmebibliotek > Gennemse... > [JRE 1.4.0 eller nyere] > OK > OK > OK > Afslut > OK).
- Bekræft, at alle kompileringsfejl er løst.
- Hvis du bruger en enkeltstående installation af Agent Controller (AC), skal du kontrollere, at den er startet (ikke påkrævet). Du kan i stedet bruge en direkte forbindelse, som er et begrænset antal AC-serviceprogrammer, der er inkluderet i arbejdsbænken.
- Åbn perspektivet Profilering og logning (Vindue > Åbn perspektiv > Andet... > Profilering og logning).
-
Udfør eksempelklassen fra perspektivet Profilering og logning (Udfør > Profil... > opret en ny startkonfiguration af typen Java-program > angiv projektnavnet til eksemplets projektnavn > angiv Overordnet klasse til 'HyadesLoggingJava14Sample' > skift til skillebladet Argumenter, og angiv følgende JVM-egenskab: -Djava.util.logging.config.file="<arbejdsområde>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" > skift til skilleblade Overvågning > fjern markeringen af "Java-profilering", og vælg "Agentopsporing" > Profil).
- Efter et par sekunder skulle logagenten automatisk blive opsporet og tilknyttet. Vælg den opsporede logagent, og åbn logoversigten i perspektivet Profilering og logning for at få vist de registrerede Common Base Event-logrecords (Vindue > Vis oversigt > Andet... > Profilering og logning > Logoversigt > OK).
- Opfrisk logoversigten i perspektivet Profilering og logning (højreklik på 'HyadesLoggingJava14Sample' Logagent > Opfrisk).
Du kan i stedet udføre eksemplet og manuelt oprette tilknytning til logagenten ved at udføre disse trin:
- Hvis arbejdsbænkens standard-JRE ikke er 1.4.0 eller nyere, skal du revidere det nye Java-projekt (dvs. LoggingJava14Project), så det kompileres og udføres vha. JRE 1.4.0 eller nyere (Projekt > Egenskaber > Java-byggesti > Biblioteker > JRE_LIB > Fjern > Tilføj bibliotek... > JRE-systembibliotek > Næste > Alternativ JRE > Installerede JRE'er... > Tilføj... > JRE-hjemmebibliotek > Gennemse... > [JRE 1.4.0 eller nyere] > OK > OK > OK > Afslut > OK).
- Bekræft, at alle kompileringsfejl er løst.
- Hvis du bruger en enkeltstående installation af Agent Controller (AC), skal du kontrollere, at den er startet (ikke påkrævet). Du kan i stedet bruge en direkte forbindelse, som er et begrænset antal AC-serviceprogrammer, der er inkluderet i arbejdsbænken.
-
Udfør eksempelklassen fra perspektivet Java (Udfør > Udfør... > opret en ny startkonfiguration af typen Java-program >
Overordnet klasse > Søg... > HyadesLoggingJava14Sample > OK > skift til skillebladet Argumenter, og angiv følgende JVM-egenskab: -Djava.util.logging.config.file="<arbejdsområde>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties" >Udfør).
- Åbn perspektivet Profilering og logning (Vindue > Åbn perspektiv > Andet... > Profilering og logning).
- Opret tilknytning til logagenten 'HyadesLoggingJava14Sample' i perspektivet Profilering og logning (Udfør > Profil... > Opret tilknytning - Java-proces > Ny > skillebladet Værter > Brug 'Direkte lokal forbindelse', hvis du ikke bruger en enkeltstående installation af Agent Controller. Ellers skal du bruge et gyldigt værtsnavn og en port. > skillebladet Agenter > dobbeltklik på agenten HyadesLoggingJava14Sample > vælg skillebladet Destination > Profileringsprojekt > Gennemse... > 'HyadesLoggingJava14Sample' > OK > Profil).
- Start overvågning af logagenten "HyadesLoggingJava14Sample" (<højreklik på logagenten "HyadesLoggingJava14Sample"> > Start overvågning).
- Åbn logoversigten i perspektivet Profilering og logning for at få vist de registrerede Common Base Event-logrecords (Vindue > Vis oversigt > Andet... > Profilering og logning > Logoversigt > OK).
- Opfrisk logoversigten i perspektivet Profilering og logning (<højreklik på logagenten "HyadesLoggingJava14Sample"> > Opfrisk).
(C) Copyright IBM Corporation 2000, 2006.