Praca z przykładem rejestrowania dla projektu Log4J

Przykład pokazuje obsługę zdarzeń zgodnych z modelem Common Base Event na platformie TPTP z wykorzystaniem API rejestrowania Apache Log4J. Z punktu widzenia użytkownika rekordy dziennika w formacie Common Base Event są zapisywane na konsolę i do agenta rejestrowania.

Jeśli nie zostało to zrobione wcześniej, utwórz przykład wybierając z menu Plik > Nowy > Przykład... > Przykład rejestrowania Apache Log4J.

Przykład zawiera kod źródłowy Java, zależności oraz plik konfiguracyjny potrzebne do rejestrowania zdarzeń w formacie Common Base Event w programie rejestrującym Apache Log4J.

Do skompilowania i wykonania tego przykładu jest potrzebne oprogramowanie Apache Log4J w wersji 1.2.8 lub nowszej (dołączone).

Założenia

  1. W przypadku uruchamiania tej aplikacji z poziomu perspektywy środowiska roboczego Profilowanie i rejestrowanie, konfiguracja startowa aplikacji albo ścieżka klasy aplikacji lub usługi komponentu Agent Controller obejmuje oprogramowanie Apache Log4J w wersji 1.2.8 lub nowszej.
  2. Zmienna środowiskowa log4j.configuration jest ustawiona na ścieżkę bezwzględną i nazwę pliku konfiguracyjnego rejestrowania Apache Log4J (HyadesLoggingLog4JSample.xml) w postaci adresu URL. Może to na przykład być file:/<obszar_roboczy>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml.
  3. Definicja typu dokumentu (DTD) Apache Log4J zdefiniowana w pliku <Plik JAR rejestrowania Apache Log4J>/org/apache/log4j/xml/log4j.dtd została skopiowana do katalogu <obszar_roboczy>/HyadesLoggingLog4JProject/cfg/, aby była dostępna dla pliku konfiguracyjnego rejestrowania Apache Log4J (file:/<workspace>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml).
Aby uruchomić ten przykład i automatycznie przyłączyć się do agenta rejestrowania, wykonaj następujące czynności:
  1. Upewnij się, że wszystkie błędy kompilacji zostały poprawione.
  2. Jeśli używana jest autonomiczna instalacja komponentu Agent Controller, upewnij się, że jest ona uruchomiona (krok nieobowiązkowy). Alternatywnie można skorzystać z połączenia bezpośredniego, czyli ograniczonego zestawu usług komponentu Agent Controller dostarczanego ze środowiskiem roboczym.
  3. Otwórz perspektywę Profilowanie i rejestrowanie (Okna > Otwórz perspektywę > Inne > Profilowanie i rejestrowanie).
  4. Z perspektywy Profilowanie i rejestrowanie uruchom nową klasę (Wykonaj > Profiluj... > Utwórz nową konfigurację wykonania typu Aplikacja Java > Jako nazwę projektu podaj nazwę projektu przykładowego > Jako klasę main podaj HyadesLoggingLog4JSample > Przejdź do karty argumentów i ustaw następującą właściwość maszyny wirtualnej: -Dlog4j.configuration="file:/<obszar_roboczy>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" > Przejdź do karty Monitor > Anuluj wybór opcji "Profilowanie Java " i wybierz opcję "Agent Discoverer" > Profluj).
  5. Agent rejestrowania powinien zostać automatycznie wykryty i przyłączony po kilku sekundach. Wybierz wykrytego agenta rejestrowania i z perspektywy Profilowanie i rejestrowanie otwórz widok dziennika, aby wyświetlić zarejestrowane rekordy dziennika w formacie Common Base Event (Okna > Pokaż widok > Inne... > Profilowanie i rejestrowanie > Widok dziennika > OK).
  6. Odśwież widok dziennika w perspektywie Profilowanie i rejestrowanie (<kliknij prawym przyciskiem myszy agenta rejestrowania HyadesLoggingLog4JSample > > Odśwież).

Można też uruchomić przykład i ręcznie przyłączyć się do agenta rejestrowania. W tym celu wykonaj następujące czynności:

  1. Upewnij się, że wszystkie błędy kompilacji zostały poprawione.
  2. Jeśli używana jest autonomiczna instalacja komponentu Agent Controller, upewnij się, że jest ona uruchomiona (krok nieobowiązkowy). Alternatywnie można skorzystać z połączenia bezpośredniego, czyli ograniczonego zestawu usług komponentu Agent Controller dostarczanego ze środowiskiem roboczym.
  3. Wykonaj przykładową klasę z perspektywy Java (Wykonaj > Wykonaj... > Utwórz nową konfigurację wykonania typu Aplikacja Java > Klasa main > Szukaj... > HyadesLoggingLog4JSample > OK > Przejdź do karty argumentów i ustaw następującą właściwość maszyny wirtualnej: -Dlog4j.configuration="file:/<obszar_roboczy>/HyadesLoggingLog4JProject/cfg/HyadesLoggingLog4JSample.xml" > Wykonaj).
  4. Otwórz perspektywę Profilowanie i rejestrowanie (Okna > Otwórz perspektywę > Inne > Profilowanie i rejestrowanie).
  5. Przyłącz się do agenta rejestrowania HyadesLoggingLog4JSample w perspektywie Profilowanie i rejestrowanie (Wykonaj > Profiluj... > Przyłącz - Proces Java > Nowa > Karta Host > Jeśli nie jest używana autonomiczna instalacja komponentu Agent Controller, wybierz opcję Lokalne połączenie bezpośrednie. W przeciwnym razie podaj poprawną nazwę hosta i port. > Karta Agenty > Dwukrotnie kliknij agenta HyadesLoggingLog4JSample > Wybierz kartę Miejsce docelowe > Projekt profilowania > Przeglądaj... > HyadesLoggingLog4JProject > OK > Profiluj).
  6. Rozpocznij monitorowanie agenta rejestrowania HyadesLoggingLog4JSample (<kliknij prawym przyciskiem myszy agenta rejestrowania HyadesLoggingLog4JSample> > Rozpocznij monitorowanie).
  7. Otwórz widok dziennika w perspektywie Profilowanie i rejestrowanie, aby wyświetlić zarejestrowane rekordy dziennika modelu Common Base Event (Okna > Pokaż widok > Inne > Profilowanie i rejestrowanie > Widok dziennika > OK).
  8. Odśwież widok dziennika w perspektywie Profilowanie i rejestrowanie (<kliknij prawym przyciskiem myszy agenta rejestrowania HyadesLoggingLog4JSample > > Odśwież).