Arbejd med eksempel på Log4J-log
Dette eksempel demonstrerer TPTP-understøttelsen af logning af Common Base Events vha. Apache Log4J 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... > Apache Log4J-logeksempel.
Indholdet af eksemplet omfatter den Java-kildekode, de afhængigheder og den konfigurationsfil, der er nødvendige for at registrere Common Base Events i en Apache Log4J-logger.
Apache Log4J 1.2.8 (inkluderet) eller nyere 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, indeholder programstartskonfigurationen eller Agent Controller-programmets eller -serviceprogrammets classpath Apache Log4J 1.2.8 eller nyere.
- Miljøvariablen "log4j.configuration" er angivet til Apache Log4J-logkonfigurationsfilens (HyadesLoggingLog4JSample.xml) absolutte sti og navn i form af en URL. Eksempel: file:/<arbejdsområde>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml.
- DTD'en til Apache Log4J (Document Type Definition) som defineret i <Apache Log4J log-JAR>/org/apache/log4j/xml/log4j.dtd kopieres til biblioteket <arbejdsområde>/HyadesLoggingLog4JProject/cfg/ til brug for Apache Log4J-logkonfigurationsfilen (file:/<arbejdsområde>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml).
Udfør følgende trin for at udføre eksemplet og automatisk oprette tilknytning til logagenten:
- 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 'HyadesLoggingLog4JSample' > skift til skillebladet Argumenter, og angiv følgende JVM-egenskab: -Dlog4j.configuration="file:/<arbejdsområde>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" > skift til skillebladet 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å logagenten "HyadesLoggingLog4JSample"> > Opfrisk).
Du kan i stedet udføre eksemplet og manuelt oprette tilknytning til logagenten ved at udføre disse trin:
- 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... > HyadesLoggingLog4JSample > OK > skift til skillebladet Argumenter, og angiv følgende JVM-egenskab:
-Dlog4j.configuration="file:/<arbejdsområde>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" > Udfør).
- Åbn perspektivet Profilering og logning (Vindue > Åbn perspektiv > Andet... > Profilering og logning).
- Opret tilknytning til logagenten 'HyadesLoggingLog4JSample' 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 HyadesLoggingLog4JSample > vælg skillebladet Destination > Profileringsprojekt > Gennemse... > 'HyadesLoggingLog4JProject' > OK > Profil).
- Start overvågning af logagenten "HyadesLoggingLog4JSample" (<højreklik på logagenten "HyadesLoggingLog4JSample"> > 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 "HyadesLoggingLog4JSample"> > Opfrisk).
(C) Copyright IBM Corporation 2000, 2006.