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

  1. 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.
  2. 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:
  1. 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).
  2. Bekræft, at alle kompileringsfejl er løst.
  3. 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.
  4. Åbn perspektivet Profilering og logning (Vindue > Åbn perspektiv > Andet... > Profilering og logning).
  5. 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).
  6. 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).
  7. 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:

  1. 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).
  2. Bekræft, at alle kompileringsfejl er løst.
  3. 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.
  4. 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).
  5. Åbn perspektivet Profilering og logning (Vindue > Åbn perspektiv > Andet... > Profilering og logning).
  6. 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).
  7. Start overvågning af logagenten "HyadesLoggingJava14Sample" (<højreklik på logagenten "HyadesLoggingJava14Sample"> > Start overvågning).
  8. Å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).
  9. Opfrisk logoversigten i perspektivet Profilering og logning (<højreklik på logagenten "HyadesLoggingJava14Sample"> > Opfrisk).