Práce s ukázkou protokolování Log4J
Tato ukázka předvádí podporu platformy TPTP pro protokolování událostí Common Base Event s použitím rozhraní API protokolování Apache Log4J.
Uživatelé se seznámí s protokolováním událostí Common Base Events do konzoly a do Agenta protokolování.
Pokud jste tak dosud neučinili, vytvořte příklad vybráním Soubor >
Nový > Příklad... > Ukázka protokolování Apache Log4J.
Obsah ukázky zahrnuje zdrojový kód Java, závislosti a konfigurační soubor nezbytný k protokolování událostí Common Base Events do registrátoru Apache Log4J.
Ke kompilaci a spuštění této ukázky je potřeba Apache Log4J 1.2.8 (zahrnuto) nebo vyšší.
Výchozí předpoklady
- Při spuštění této aplikace v perspektivě pracovní plochy Profilování a protokolování konfigurace spuštění aplikace, aplikace nebo služba Řadič agentů nebo cesta ke třídě služby obsahuje ve své cestě ke třídě položku Apache Log4J verze 1.2.8 nebo vyšší.
- Proměnná prostředí 'log4j.configuration' obsahuje absolutní cestu a název konfiguračního souboru protokolování Apache Log4J (HyadesLoggingLog4JSample.xml) ve formě adresy URL. Například soubor:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml.
- Definice typu dokumentu Apache Log4J (DTD), jak je definovaná v <souboru JAR protokolování Apache Log4J>/org/apache/log4j/xml/log4j.dtd, je zkopírovaná do adresáře <workspace>/HyadesLoggingLog4JProject/cfg/ pro použití konfiguračním souborem protokolování Apache Log4J (file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml).
Chcete-li tuto ukázku spustit a automaticky připojit k Agentu protokolování, proveďte následující kroky:
- Potvrďte, že všechny chyby kompilace byly opraveny.
- Pokud používáte samostatnou instalaci Řadiče agentů, zkontrolujte, zda je spuštěný (není požadováno). Volitelně můžete použít přímé připojení, což je omezený počet služeb Řadiče agentů obsažený v pracovní ploše.
- Otevřete perspektivu Profilování a protokolování (Okno > Otevřít perspektivu > Další...... > Profilování a protokolování).
-
Spusťte ukázkovou třídu z Perspektivy Profilování a protokolování (Spustit > Profilovat... > Vytvořit novou konfiguraci spuštění typu Aplikace Java > Nastavit název projektu na název projektu příkladu > Nastavit hlavní třídu na 'HyadesLoggingLog4JSample'
> Přepnout na kartu Argumenty a uvést následující vlastnost JVM: -Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml"
>Přepnout na kartu Monitor > Zrušit zaškrtnutí "Profilování Java" a zaškrtnout "Objevitel agent" > Profilovat).
- Po několika sekundách by měl být agent protokolování automaticky zjištěn a připojen. Vyberte zjištěného agenta protokolování a otevřete pohled Protokol v perspektivě Profilování a protokolování. Tím se zobrazí záznamy protokolu zaprotokolovaných událostí Common Base Event (Okno > Zobrazit pohled > Jiný... > Profilování a protokolování > Pohled Protokol > OK).
- Obnovte pohled Protokol v perspektivě Profilování a protokolování (<klepněte pravým tlačítkem myši na agenta protokolování 'HyadesLoggingLog4JSample' > > Obnovit).
Volitelně, chcete-li tuto ukázku spustit a ručně připojit k Agentu protokolování, proveďte následující kroky:
- Potvrďte, že všechny chyby kompilace byly opraveny.
- Pokud používáte samostatnou instalaci Řadiče agentů, zkontrolujte, zda je spuštěný (není požadováno). Volitelně můžete použít přímé připojení, což je omezený počet služeb Řadiče agentů obsažený v pracovní ploše.
-
Spusťte ukázkovou třídu z perspektivy Profilování a protokolování (Spustit > Spustit... > Vytvořit novou konfiguraci spuštění typu Aplikace Java
> Hlavní třída > Hledat... > HyadesLoggingLog4JSample > OK >Přepnout na kartu Argumenty a uvést následující vlastnost JVM:
-Dlog4j.configuration="file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" >
Spustit).
- Otevřete perspektivu Profilování a protokolování (Okno > Otevřít perspektivu > Další...... > Profilování a protokolování).
- Připojte se k agentu protokolování 'HyadesLoggingLog4JSample' v perspektivě Profilování a protokolování (Spustit > Profilovat... > Připojit - proces Java > Nový > Karta Hostitelé > Použít 'Lokální přímé připojení', pokud nepoužíváte samostatnou instalaci Řadiče agentů. Jinak použijte platný název_hostitele a port. > Karta Agenti > Poklepat na agenta HyadesLoggingLog4JSample > Vybrat kartu Místo určení > Projekt profilování > Procházet... > 'HyadesLoggingLog4JProject' > OK > Profilovat).
- Spusťte monitorování agenta protokolování 'HyadesLoggingLog4JSample' (<klepněte pravým tlačítkem myši na agenta protokolování 'HyadesLoggingLog4JSample' > > Spustit monitorování).
- Otevřete pohled Protokol v perspektivě Profilování a protokolování, aby se zobrazily zaprotokolované záznamy události Common Base Event (Okno> Zobrazit pohled > Další... > Profilování a protokolování > Pohled Protokol > OK).
- Obnovte pohled Protokol v perspektivě Profilování a protokolování (<klepněte pravým tlačítkem myši na agenta protokolování 'HyadesLoggingLog4JSample' > > Obnovit).
(C) Copyright IBM Corporation 2000, 2006.