Ustawienia dziennika wirtualnej maszyny języka Java (JVM)

Na tej stronie można przeglądać i modyfikować ustawienia dzienników System.out oraz System.err wirtualnej maszyny języka Java.

Obsługiwane konfiguracje: Do tej strony można uzyskać dostęp tylko wtedy, gdy serwer jest skonfigurowany do korzystania z podstawowego trybu dziennika i śledzenia.sptcfg

Aby wyświetlić tę stronę Konsoli administracyjnej, należy kliknąć opcję Rozwiązywanie problemów > Dzienniki i dane śledzenia > nazwa_serwera > Dzienniki maszyny JVM.

Umożliwia ona wyświetlanie i zmianę ustawień dzienników System.out oraz System.err wirtualnej maszyny języka Java (JVM) dla tego zarządzanego procesu. Dzienniki maszyny JVM są tworzone przez przekierowanie strumieni System.out i System.err maszyny JVM do niezależnych plików dzienników. Dziennik strumienia System.out jest używany do monitorowania poprawności działania serwera aplikacji. Dziennik strumienia System.err zawiera informacje śledzenia stosu wyjątków. Są one przydatne przy analizowaniu problemów. Istnieje jeden zestaw dzienników maszyny JVM dla każdego serwera aplikacji i wszystkich jego aplikacji. Dzienniki maszyny JVM są również tworzone dla menedżera wdrażania i menedżera każdego węzła. Zmiany wprowadzone na panelu konfiguracji są stosowane po zrestartowaniu serwera. Zmiany wprowadzone na panelu środowiska wykonawczego są stosowane natychmiast.

Uwaga: Ten temat odwołuje się do co najmniej jednego pliku dziennika serwera aplikacji. Zalecanym rozwiązaniem alternatywnym w systemach rozproszonych oraz w systemach IBM® i jest skonfigurowanie serwera tak, aby korzystał z infrastruktury rejestrowania i śledzenia HPEL (High Performance Extensible Logging), a nie z plików SystemOut.log, SystemErr.log, trace.log i activity.log. Ponadto można korzystać z rejestrowania HPEL w połączeniu z rodzimymi narzędziami do rejestrowania systemu z/OS. W przypadku korzystania z dziennika HPEL można uzyskać dostęp do wszystkich informacji dziennika i śledzenia, używając z poziomu katalogu bin profilu serwera narzędzia wiersza komend LogViewer. Więcej informacji na temat korzystania z dziennika HPEL zawiera sekcja dotycząca używania dziennika HPEL do rozwiązywania problemów z aplikacjami.

Nazwa pliku

Określa nazwę jednego z plików dziennika, których dotyczy ta strona.

Pierwsze pole nazwy pliku określa nazwę pliku strumienia System.out. Drugie pole nazwy pliku określa nazwę pliku strumienia System.err.

Unikanie problemów: Ten plik nie może być współużytkowany przez serwery. Serwer tworzy plik z rozszerzeniem .owner, aby ułatwić wykrycie sytuacji, w której co najmniej dwa serwery próbują użyć tego samego pliku.gotcha

Aby wyświetlić treść wybranego pliku dziennika, należy nacisnąć przycisk Wyświetl na karcie środowiska wykonawczego.

Nazwa pliku określona dla dziennika System.out lub dziennika System.err powinna przyjąć jedną z następujących wartości:

nazwa_pliku: Nazwa pliku w systemie plików. Zaleca się używanie pełnej nazwy pliku. Jeśli podana nazwa nie jest pełną nazwą pliku, jest ona domyślnie uznawana za nazwę względem bieżącego katalogu roboczego danego serwera. Każdy strumień musi być skonfigurowany za pomocą osobnego pliku. Nie można na przykład przekierować dzienników System.out i System.err do jednego pliku fizycznego.
Jeśli katalog danego pliku został utworzony wcześniej, ID użytkownika dla którego uruchomiono serwer powinien mieć dostęp do odczytu/zapisu w tym katalogu. Jeśli katalog nie istnieje, zostanie utworzony nowy katalog z odpowiednimi uprawnieniami. ID użytkownika, dla którego działa serwer, powinien posiadać uprawnienia do utworzenia nowego katalogu.
konsola: Jest to specjalna nazwa pliku, używana do przekierowywania strumienia do odpowiedniego strumienia procesu. Jeśli wartość będzie określona dla System.out, plik zostanie przekierowany do stdout. Jeśli wartość będzie określona dla System.err, plik zostanie przekierowany do stderr.
Brak: Usuwa wszystkie dane wpisane do strumienia. Określenie wartości none odpowiada przekierowaniu strumienia do urządzenia dev/null w takich systemach operacyjnych, jak AIX lub Linux.

Domyślną ścieżką dla nazwy_pliku jest wartość zmiennej SERVER_LOG_ROOT (KATALOG_GŁÓWNY_DZIENNIKÓW_SERWERA). Aby wyświetlić wartość zmiennej SERVER_LOG_ROOT, wykonaj następującą procedurę:

W Konsoli administracyjnej wybierz opcję Środowisko > Zmienne produktu WebSphere.
Kliknij przełącznik Serwer, a następnie przycisk Zastosuj. Wartość zmiennej SERVER_LOG_ROOT zostanie wyświetlona na liście.

Aby zmienić wartość zmiennej SERVER_LOG_ROOT, wykonaj następującą procedurę:

Wybierz opcję SERVER_LOG_ROOT (KATALOG_GŁÓWNY_DZIENNIKÓW_SERWERA)
Wprowadź nową ścieżkę w polu Wartość.
Kliknij przycisk Zastosuj
Zapisz konfigurację. Aby zmiany zostały zastosowane, zrestartuj serwer.

Ponadto, istnieje możliwość zmiany położenia i nazwy plików dziennika ${SERVER_LOG_ROOT}/SystemOut.log i ${SERVER_LOG_ROOT}/SystemErr.log, oraz określenie dowolnej innej ścieżki bezwzględnej i nazwy pliku (na przykład /tmp/myLogfile.log).

Formatowanie pliku

Określa format używany przy zapisywaniu pliku strumienia System.out.

Rotacja pliku dziennika

Za pomocą tego zestawu atrybutów konfiguracji można skonfigurować plik dziennika System.out lub System.err jako samozarządzający.

Samozarządzający plik dziennika zapisuje komunikaty do pliku do momentu osiągnięcia kryterium czasu lub wielkości. W określonym czasie lub po osiągnięciu określonej wielkości rejestrowanie zostanie czasowo zawieszone w momencie przełączania pliku dziennika, wymagającego zamknięcia i zmiany nazwy zapisanego pliku. Nazwa nowo zapisanego pliku składa się z nazwy oryginalnego pliku i kwalifikatora znacznika czasu, wskazującego czas zmiany nazwy. Po zmianie nazwy zostanie otwarty nowy, pusty plik dziennika z oryginalną nazwą i rejestrowanie będzie wznowione. Po przełączeniu pliku dziennika wszystkie komunikaty pozostaną zapisane, przy czym pojedynczy komunikat może zostać podzielony między zapisany i bieżący plik dziennika.

Plik dziennika można skonfigurować jako samozarządzający tylko wtedy, gdy odpowiedni strumień jest przekierowany do pliku.

Wielkość pliku: Kliknij ten atrybut, aby samozarządzający plik dziennika przełączał się na podstawie wielkości pliku. Automatyczne przełączenie nastąpi po osiągnięciu przez plik wielkości określonej w polu wielkości maksymalnej.
Wielkość maksymalna: Określa maksymalną wielkość pliku w megabajtach. Po osiągnięciu tej wielkości plik się przełączy.
Ten atrybut jest brany pod uwagę tylko po kliknięciu atrybutu Wielkość pliku.
Godzina: Kliknij ten atrybut dla pliku dziennika, aby włączyć automatyczne zarządzanie na podstawie określonej godziny. Plik będzie przełączał się o godzinie określonej w polu Czas rozpoczęcia.
Czas rozpoczęcia: Określa godzinę z zakresu od 1 do 24, o której algorytm przełączenia okresowego będzie uruchamiany po raz pierwszy po zrestartowaniu serwera aplikacji. Algorytm ładuje się podczas uruchamiania serwera aplikacji. Po uruchomieniu o godzinie podanej w polu Czas rozpoczęcia, algorytm przełączenia przełącza plik w odstępach czasu podanych w polu czas powtórzenia (w godzinach). Ten wzór przełączania jest używany do momentu zatrzymania serwera aplikacji bez potrzeby ponownego ustawiania.
Uwaga: Przełączanie uruchamia się zawsze na początku godziny określonej w atrybucie. Pierwsza godzina dnia rozpoczyna się o 00:00:00 (północy) i jest określana liczbą 1, a ostatnia godzina dnia rozpoczyna się o 23:00:00 i jest określana liczbą 24. Zatem jeśli pliki dziennika mają się przełączać o północy, należy ustawić wartość 1 w atrybucie Czas rozpoczęcia.
Czas powtórzenia: Określa w godzinach odstęp czasu, po którym plik dziennika przełącza się. Poprawne wartości to liczby z zakresu od 1 do 24.

Plik dziennika można skonfigurować w celu przełączania się według czasu, według wielkości lub według czasu i wielkości. Aby plik przełączał się po osiągnięciu pierwszego z określonych kryteriów, kliknij pola Wielkość pliku i Godzina. Jeśli na przykład wartość czasu powtórzenia wynosi 5 godzin i wartość maksymalnej wielkości wynosi 2 MB, plik przełącza się co 5 godzin, o ile nie osiągnie wielkości 2 MB przed upłynięciem odstępu czasu. Po przełączeniu wskutek osiągnięcia maksymalnej wielkości, plik będzie nadal przełączany w określonych odstępach czasu.

Maksymalna liczba historycznych plików dzienników

Określa maksymalną liczbę historycznych plików, przechowywanych po przełączeniach. Do momentu przełączenia, strumień zapisuje w pliku bieżącym. W momencie przełączenia plik bieżący jest zamykany i zapisywany z nową nazwą, złożoną z nazwy bieżącej i znacznika czasu przełączenia. Następnie strumień otwiera nowy plik z oryginalną nazwą i kontynuuje zapisywanie. Liczba plików historycznych zwiększa się narastająco, od zera do liczby określonej w wartości maksymalnej liczby plików historycznych. Przy kolejnym rejestrowaniu najstarszy plik historyczny zostanie usunięty.

Dane wyjściowe zainstalowanej aplikacji

Określa, czy instrukcje wyświetlania plików System.out i System.err będą rejestrowane i formatowane.

Pokaż instrukcje wyświetlania aplikacji: Kliknij to pole, aby wyświetlić komunikaty zapisywane przez aplikacje w strumieniu za pomocą metod strumienia print i println. Komunikaty serwera WebSphere Application Server są wyświetlane zawsze.
Formatuj instrukcje wyświetlania: Kliknij to pole, aby sformatować instrukcje wyświetlania aplikacji, np. komunikaty systemowe serwera WebSphere Application Server.

Nazwa pliku: utrb_jvmlogs.html