Konfigurowanie rejestrowania
Rejestrowanie jest istotnym aspektem działania każdej aplikacji serwerowej. Komponent Agent
Controller umożliwia rejestrowanie na potrzeby debugowania i raportowania. Służy do tego pojedynczy plik
dziennika o nazwie servicelog.log, domyślnie znajdujący się w katalogu config, w którym
zainstalowany jest komponent Agent Controller. Rejestrowanie można skonfigurować poprzez:
Zmiana domyślnego katalogu rejestrowania
W pewnych sytuacjach może zajść konieczność zmiany domyślnego katalogu rejestrowania. Może to na przykład
być konieczne w przypadku systemów, w których komponent Agent Controller zainstalowano w systemie plików tylko
do odczytu.
Aby zmienić domyślny katalog rejestrowania, należy wykonać następujące czynności:
- Odszukaj plik konfiguracyjny serviceconfig.xml. Patrz sekcja Czynności pokrewne.
- Otwórz plik w edytorze i znajdź element <Logging>.
- Określ nowy katalog rejestrowania, podając go jako wartość atrybutu directory tego elementu.
Modyfikowanie filtrów rejestrowania
Korzystając z prostego filtru rejestrowania, można wymusić zapisywanie w pliku dziennika wyłącznie komunikatów poniżej pewnego poziomu rejestrowania. Istnieją następujące poziomy rejestrowania:
- SEVERE: rejestrowane są tylko komunikaty o błędach niemożliwych do naprawienia.
- CRITICAL: (wartość domyślna) obejmuje komunikaty rejestrowane na poziomie SEVERE oraz komunikaty wskazujące, że normalne działanie zostało przerwane ze względu na wystąpienie błędu.
- WARNING: obejmuje komunikaty rejestrowane na poziomie CRITICAL oraz komunikaty dotyczące niespodziewanych zdarzeń, które nie powinny zakłócić ciągłości działania.
- INFORMATION: obejmuje komunikaty rejestrowane na poziomie WARNING oraz komunikaty o normalnych zdarzeniach, które mogą zainteresować użytkownika.
- DEBUG: obejmuje komunikaty rejestrowane na poziomie INFORMATION oraz komunikaty dotyczące szczegółowego przepływu wewnętrznych operacji, przydatne przy rozwiązywaniu problemów.
Aby zmodyfikować filtry rejestrowania, należy wykonać następujące czynności:
- W pliku serviceconfig.xml odszukaj element <Logging>.
- Zmień stosownie do wymagań wartość atrybutu level na jeden z powyższych poziomów rejestrowania.
Zmiana formatu rejestrowanych komunikatów
Rejestrowane komunikaty mogą mieć format tekstowy lub CBE. Dostępne specyfikacje formatów to:
- CBE:
(wartość domyślna) komunikaty będą rejestrowane przy użyciu formatu Common Base Event. Obejmuje to szczegółowe informacje o kontekście i źródle każdego komunikatu. Komunikaty najłatwiej odczytać przy użyciu narzędzia do odczytywania dzienników w formacie CBE.
- Prosty: komunikaty będą rejestrowane w formie tekstowej.
Aby zmodyfikować format rejestrowania, należy wykonać następujące czynności:
- W pliku serviceconfig.xml odszukaj element <Logging>.
- Zmień stosownie do wymagań wartość atrybutu formatu na jeden z powyższych formatów rejestrowania.
Czynności pokrewne
Określanie położenia plików konfiguracyjnych
Administrowanie komponentem Agent Controller