Temat zawiera opis konfigurowania i zarządzania ustawieniami poziomu dzienników.
Aby wyświetlić tę stronę Konsoli administracyjnej, należy kliknąć opcję .
Poziomy dziennika umożliwiają wybieranie zdarzeń, które mają być przetwarzane podczas rejestrowania Java. Zmiany poziomu w programie rejestrującym są propagowane na potomne programy rejestrujące.
- Wyłączenie rejestrowania i śledzenia potencjalnie wrażliwych danych
- Serwer aplikacji dysponuje listą programów rejestrujących, które, gdy są włączone, potencjalnie mogą zapisywać do danych rejestrowania i śledzenia wrażliwe informacje. Na przykład włączenie niektórych programów rejestrujących protokołu HTTP na poziomie NAJDOKŁADNIEJ może spowodować zapisanie w plikach śledzenia żądań HTTP zawierających poufne informacje konkretnych użytkowników. Aby serwer nie włączał tych programów rejestrujących na poziomach, o których wiadomo, że mogą potencjalnie przetwarzać informacje poufne, należy zaznaczyć pole wyboru Wyłącz rejestrowanie oraz śledzenie danych potencjalnie poufnych. Gdy serwer zostanie uruchomiony lub gdy specyfikacja poziomu szczegółowości rejestrowania zostanie zmodyfikowana w czasie wykonywania, serwer porówna listę programów rejestrujących i poziomów określoną w specyfikacji poziomu szczegółowości rejestrowania z listą programów rejestrujących i poziomów na liście programów rejestrujących wrażliwe dane oraz zaktualizuje w razie potrzeby specyfikację poziomu szczegółowości rejestrowania.
- Zmiana poziomu szczegółowości dzienników
Zmiana polega na wyborze poziomu szczegółowości, który określa komponenty, pakiety i grupy dla śledzenia. Łańcuch poziomu szczegółowości dziennika podlega określonym regułom gramatyki, które opisano w tym temacie. Łańcuch poziomu szczegółowości dziennika można wprowadzić bezpośrednio lub wygenerować za pomocą graficznego interfejsu ustawień śledzenia.
Po wybraniu karty Konfiguracja i rozwinięciu węzła Komponenty i grupy zostanie wyświetlona statyczna lista powszechnie znanych komponentów, pakietów i grup. Lista ta nie może być wyczerpująca.
Po wybraniu karty Środowisko wykonawcze i rozwinięciu węzła Komponenty i grupy, zostanie wyświetlona lista komponentów, pakietów i grup zawierająca wszystkie komponenty zarejestrowane na działającym serwerze aplikacji i na liście statycznej.
Format specyfikacji poziomu szczegółowości dziennika:<komponent> = <poziom>
gdzie <komponent> to komponent, dla którego ma zostać ustawiony poziom szczegółowości dziennika, a <poziom> to jeden z poprawnych poziomów programu rejestrującego: off (wyłączone), fatal (krytyczne), severe (istotne), warning (ostrzeżenie), audit (kontrola), info (informacja), config (konfiguracja), detail (szczegóły), fine (dokładnie), finer (dokładniej), finest (najdokładniej), all (wszystko). Poszczególne specyfikacje poziomów dziennika należy rozdzielać dwukropkami (:).
Unikanie problemów: Klauzule uwzględnione w specyfikacji śledzenia są odczytywane w kolejności, w
jakiej występują w łańcuchu. Dlatego jeśli specyfikacja śledzenia zawiera wiele
wariantów klauzuli *=info, poziom śledzenia, z jakim system rejestruje dane, jest
określony przez ostatnią wartość. Określenie wartości
*=info jako ostatniej klauzuli spowoduje, że śledzenie
będzie się odbywać na poziomie informacyjnym, niezależnie od innych klauzul
określonych w łańcuchu śledzenia. Jeśli na przykład zostanie określony
następujący łańcuch śledzenia:
będzie on równoważny następującemu łańcuchowi:*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all
Wynika to stąd, że ostatnia klauzula przesłania wszystkie klauzule określone wcześniej w łańcuchu.gotcha*=allKomponenty odpowiadają pakietom i klasom języka Java lub kolekcjom pakietów języka Java. Aby wskazać komponenty zawierające wszystkie klasy w pakietach zawartych w określonym komponencie, można używać znaku zastępczego gwiazdka (*). Na przykład:- *
- Określa wszystkie kody, które można śledzić na danym serwerze aplikacji, w tym kod systemowy produktu i kod klienta.
- com.ibm.ws.*
- Określa wszystkie klasy, których nazwy pakietów rozpoczynają się od com.ibm.ws.
- com.ibm.ws.classloader.JarClassLoader
- Określa tylko klasę JarClassLoader.
Jeśli podczas ustawiania specyfikacji poziomu szczegółowości dziennika w Konsoli administracyjnej będą wybrane jednocześnie pozycje z list Grupy i Komponenty, może wystąpić błąd. W niektórych przypadkach wybór dokonany na jednej liście może zostać zignorowany po dodaniu wyboru z drugiej listy. Aby uniknąć tego problemu, należy wpisać specyfikację poziomu szczegółowości dziennika bezpośrednio w polu wprowadzenia poziomu szczegółowości dziennika.
Unikanie problemów: W wartościach poziomu rejestrowania rozróżniana jest
wielkość liter. Zaczynają się one od małej litery.gotcha| Poziom rejestrowania w wersji 6 lub nowszej | Zawartość / Znaczenie |
|---|---|
| off (wyłączone) | Rejestrowanie jest wyłączone. |
| fatal (krytyczny) | Czynność nie może być kontynuowana, a komponent, aplikacja i serwer nie działają. |
| severe (poważny) | Zadanie nie może być kontynuowane, ale komponent, aplikacja i serwer działają w dalszym ciągu. Ten poziom może również wskazywać, że w bliskiej przyszłości wystąpi błąd nienaprawialny. |
| warning (ostrzeżenie) | Możliwy błąd lub błąd w bliskiej przyszłości. Poziom ten może również wskazywać postępującą awarię (na przykład możliwy przeciek zasobów). |
| audit (kontrola) | Zdarzenie istotne dla modyfikacji stanu lub zasobów serwera. |
| info (informacja) | Informacje ogólne przedstawiające całkowity postęp czynności. |
| config (konfiguracja) | Zmiana lub status konfiguracji. |
| detail (szczegóły) | Informacje ogólne przedstawiające szczegółowo postęp podzadań. |
| fine (dokładnie) | Informacje o śledzeniu - Śledzenie ogólne + wartości pozycji metody, wyjścia i, wartości zwracane. |
| finer (dokładniej) | Informacje o śledzeniu - szczegółowe śledzenie. |
| finest (najdokładniej) | Informacje o śledzeniu - Śledzenie bardziej szczegółowe, obejmuje wszystkie zdarzenia na poziomie potrzebnym do debugowania problemów. |
| all (wszystko) | Wszystkie zdarzenia będą rejestrowane. W przypadku tworzenia poziomów niestandardowych każdy poziom obejmuje poziomy podane powyżej, przy czym można określić poziom dokładniejszy od Finest (Najdokładniej). |
[Rejestrowanie w trybie podstawowym] Informacje pochodzące ze śledzenia i obejmujące zdarzenia na poziomach Fine (Dokładnie), Finer (Dokładnie) i Finest (Najdokładniej) mogą być zapisywane wyłącznie w dzienniku śledzenia. Zatem jeśli nie uruchomisz śledzenia diagnostycznego, ustawienie poziomu szczegółowości dziennika na Fine (Dokładnie), Finer (Dokładnie) i Finest (Najdokładniej) będzie zignorowane przy zapisywaniu danych.
- Korelacja
- Służy do określania ustawień korelacji, które mają zostać włączone. Należy
zaznaczyć pole wyboru Włącz korelację dziennika i danych
śledzenia, aby włączyć korelację dla serwera aplikacji. Należy
usunąć zaznaczenie pola wyboru Włącz korelację dziennika i danych
śledzenia, aby wyłączyć korelację dla serwera aplikacji. Zgodnie z potrzebami należy wybrać opcję
Uwzględnij identyfikatory żądań w rekordach dziennika i
śledzenia, Uwzględnij identyfikatory żądań w rekordach
dziennika i śledzenia oraz utwórz rekordy dziennika korelacji lub
Uwzględnij identyfikatory żądań w rekordach dziennika i śledzenia,
utwórz rekordy dziennika korelacji i przechwyć obrazy stanu
danych.
Sprawdzona procedura: Śledzenie
XCT należy włączyć w celu dołączania identyfikatorów żądań do plików dziennika
i śledzenia, aby określić wpisy dotyczące danego żądania spośród wszystkich
wątków i procesów serwera aplikacji. Identyfikatory żądań są rejestrowane tylko
wtedy, gdy używany jest tryb dziennika i śledzenia HPEL. Do ich wyświetlenia
lub użycia na potrzeby filtrowania należy zastosować komendę logViewer. bprac Sprawdzona procedura: Śledzenie XCT należy włączyć w celu utworzenia rekordów dziennika korelacji,
aby rejestrować rozgałęzienia żądań między wątkami i procesami oraz wyświetlać
dodatkowe informacje o poszczególnych żądaniach.
Włączenie śledzenia XCT w celu
tworzenia rekordów dziennika korelacji może mieć istotny wpływ na wydajność
systemu, dlatego jego zastosowanie najlepiej ograniczyć do środowisk testowych i
programistycznych.bprac Sprawdzona procedura: Śledzenie XCT należy włączyć
w celu przechwytywania obrazów stanu danych, aby zapisywać całą treść żądań i
odpowiedzi w systemie plików. Włączenie śledzenia XCT w celu przechwytywania
obrazów stanu może mieć istotny wpływ na wydajność systemu, dlatego jego
zastosowanie najlepiej ograniczyć do środowisk testowych i programistycznych. Śledzenie
XCT przechwytuje obrazy stanu danych dla żądań i odpowiedzi komunikatów
obsługiwanych przez magistralę SIBus.bprac Unikanie problemów: Obrazy
stanu danych są przechwytywane i zapisywane w katalogu
$katalog_główny_dziennika_serwera/snapdata.
Serwer aplikacji nie wykonuje automatycznego czyszczenia plików z tego
katalogu. Po włączeniu przechwytywania obrazów stanu danych należy okresowo
usuwać pliki z tego katalogu. Obrazy stanu danych zawierają całą treść
żądań i odpowiedzi i mogą zawierać poufne informacje. Użycie tej opcji może
nie być odpowiednie w środowiskach produkcyjnych.gotcha
- Zapisz w konfiguracji również zmiany wykonawcze
- Wskazuje, że zmiany mają zostać wprowadzone zarówno w ramach stanu dynamicznego działającego serwera, jak i w jego konfiguracji, która zostanie użyta przy następnym restarcie. Jeśli to pole wyboru nie zostanie zaznaczone, serwer nie skopiuje tych ustawień do konfiguracji serwera.