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

  1. 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šší.
  2. 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.
  3. 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:
  1. Potvrďte, že všechny chyby kompilace byly opraveny.
  2. 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.
  3. Otevřete perspektivu Profilování a protokolování (Okno > Otevřít perspektivu > Další...... > Profilování a protokolování).
  4. 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).
  5. 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).
  6. 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:

  1. Potvrďte, že všechny chyby kompilace byly opraveny.
  2. 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.
  3. 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).
  4. Otevřete perspektivu Profilování a protokolování (Okno > Otevřít perspektivu > Další...... > Profilování a protokolování).
  5. 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).
  6. Spusťte monitorování agenta protokolování 'HyadesLoggingLog4JSample' (<klepněte pravým tlačítkem myši na agenta protokolování 'HyadesLoggingLog4JSample' > > Spustit monitorování).
  7. 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).
  8. Obnovte pohled Protokol v perspektivě Profilování a protokolování (<klepněte pravým tlačítkem myši na agenta protokolování 'HyadesLoggingLog4JSample' > > Obnovit).