Rejestrowanie (logging)

Steruje przechwytywaniem i wyprowadzaniem komunikatów dziennika i komunikatów ze śledzenia.

Nazwa	Typ	Wartość domyślna	Opis
appsWriteJson	wartość boolowska	false	Gdy dziennik komunikatów lub dziennik konsoli jest zapisany w formacie JSON, zezwalaj aplikacjom na zapis niezmodyfikowanych komunikatów w formacie JSON w tych miejscach docelowych.
consoleFormat	DEV JSON SIMPLE TBASIC	DEV	Wymagany format konsoli. Poprawne wartości to format DEV, SIMPLE lub JSON. Domyślnie parametr consoleFormat jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_CONSOLE_FORMAT (jeśli ją ustawiono) lub wartość DEV. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_CONSOLE_FORMAT lub właściwości com.ibm.ws.logging.console.format. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu. DEV Użyj formatu DEV rejestrowania. JSON Użyj formatu JSON rejestrowania. SIMPLE Użyj prostego (SIMPLE) formatu rejestrowania. TBASIC Użyj formatu tbasic rejestrowania.
consoleLogLevel	AUDIT ERROR INFO OFF WARNING	AUDIT	Poziom rejestrowania używany w celu filtrowania komunikatów zapisywanych do strumieni systemowych. Poprawne wartości to INFO, AUDIT, WARNING, ERROR i OFF. Domyślnie właściwość consoleLogLevel jest ustawiona na wartość zmiennej środowiskowej WLP_LOGGING_CONSOLE_LOGLEVEL (jeśli ją ustawiono) lub wartość AUDIT. Uwaga: Przed zmianą tej wartości należy wziąć pod uwagę informacje zawarte w sekcji "Nie można wchodzić w interakcje z serwerem Liberty po zmodyfikowaniu ustawień poziomu rejestrowania danych z konsoli" tematu dotyczącego znanych ograniczeń narzędzi Developer Tools. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_CONSOLE_LOGLEVEL lub właściwości com.ibm.ws.logging.console.level. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu. AUDIT Komunikaty kontrolne i ostrzegawcze będą zapisywane do systemowego strumienia wyjściowego. Komunikaty o błędach będą zapisywane do systemowego strumienia błędów. ERROR Komunikaty o błędach będą zapisywane do systemowego strumienia błędów. INFO Komunikaty informacyjne, kontrolne i ostrzegawcze będą zapisywane do systemowego strumienia wyjściowego. Komunikaty o błędach będą zapisywane do systemowego strumienia błędów. OFF Wyjście serwera nie jest zapisywane do strumieni systemowych. Do strumieni systemowych jest zapisywane tylko wyjście maszyny JVM. WARNING Komunikaty ostrzegawcze będą zapisywane do systemowego strumienia wyjściowego. Komunikaty o błędach będą zapisywane do systemowego strumienia błędów.
consoleSource	string	message	Lista źródeł rozdzielonych przecinkami, które kierują dane do pliku console/console.log. Ta właściwość ma zastosowanie tylko wtedy, gdy atrybut consoleFormat=json. Poprawne wartości to: message, trace, accessLog, ffdc i audit. Domyślnie parametr consoleSource jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_CONSOLE_SOURCE (jeśli ją ustawiono) lub wartość message. Uwaga: Aby użyć źródła na poziomie audit, włącz funkcję kontroli Liberty. Włącz dzienniki dostępu, ustawiając element accessLogging dla punktu końcowego httpEndpoint. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_CONSOLE_SOURCE lub właściwości com.ibm.ws.logging.console.source. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
copySystemStreams	wartość boolowska	true	Jeśli właściwość ta ma wartość true, komunikaty zapisywane do strumieni System.out i System.err są kopiowane do pliku console.log. Jeśli ma ona wartość false, komunikaty są zapisywane w skonfigurowanych dziennikach, takich jak messages.log lub trace.log, ale nie są kopiowane do pliku console.log. Domyślną wartością jest true (prawda). Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.copy.system.streams. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
hideMessage	string		Rozdzielana przecinkami lista komunikatów, które są skonfigurowane do ukrycia w plikach console.log i messages.log. Jeśli komunikaty są skonfigurowane jako ukryte, są przekierowywane do pliku trace.log. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.hideMessage. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
isoDateFormat	wartość boolowska	false	Data i godzina są używane w formacie właściwym dla ustawień narodowych lub w formacie ISO-8601. Istnieje możliwość określenia wartości true lub false dla wartości tego atrybutu lub wartości odpowiedniej właściwości. Wartość domyślna to false. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.isoDateFormat. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu. Jeśli zostanie podana wartość true, w plikach messages.log i trace.log oraz w dziennikach FFDC będzie używany format ISO-8601. Format jest następujący: yyyy-MM-dd'T'HH:mm:ss.SSSZ. Jeśli zostanie podana wartość false, data i godzina zostaną sformatowane zgodnie z domyślnymi ustawieniami narodowymi systemu. Jeśli domyślne ustawienia narodowe nie zostaną znalezione, formatem będzie dd/MMM/yyyy HH:mm:ss:SSS z.
jsonAccessLogFields	default logFormat	default	Gdy dzienniki są zapisywane w formacie JSON, za pomocą tego atrybutu można nakazać użycie pól dzienników dostępu określonych we właściwości logFormat konfiguracji accessLogging albo domyślnych pól dzienników dostępu. default Użyj domyślnego zestawu pól dzienników dostępu. logFormat Użyj zestawu pól dzienników dostępu zgodnego z logFormat.
jsonFieldMappings	string		Jeśli dzienniki są w formacie JSON, za pomocą tego atrybutu można zastąpić domyślne nazwy pól nowymi nazwami pól lub pominąć w dziennikach. Aby zastąpić nazwę pola, skonfiguruj nową nazwę przy użyciu następującego formatu: domyślna_nazwa_pola:nowa_nazwa_pola?. W przypadku nazw pól powiązanych z dziennikami określonego źródła, należy użyć formatu [źródło:]?domyślna_nazwa_pola:nowa_nazwa_pola, gdzie [źródło] oznacza określone źródło, np. message, trace lub accessLog. Aby pominąć pole w dziennikach, określ nazwę pola bez nazwy ją zastępującej, tak jak przedstawiono to w przykładzie: domyślna_nazwa_pola:. Aby zmienić nazwy wielu pól lub pominąć wiele pól, należy podać rozdzielaną przecinkami listę odwzorowań nazw pól.
logDirectory	Ścieżka do katalogu	${server.output.dir}/logs	Można użyć tego atrybutu do ustawienia katalogu dla wszystkich plików dziennika, z wyjątkiem pliku console.log, ale z uwzględnieniem pliku FFDC. Domyślnie parametr logDirectory jest ustawiony na zmienną środowiskową LOG_DIR. Domyślna ścieżka do zmiennej środowiskowej LOG_DIR to WLP_OUTPUT_DIR/serverName/logs. Aby uniknąć problemów, należy używać zmiennej środowiskowej LOG_DIR lub właściwości com.ibm.ws.logging.log.directory. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
maxFfdcAge	Okres z dokładnością do minuty	-1	Maksymalny oczekiwany wiek przed usunięciem pliku FFDC. Podaj dodatnią liczbę całkowitą, po której następuje jednostka czasu, którą może być dzień (d), godzina (h) lub minuta (m). Na przykład podaj 2 dni jako 2d. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład wartość 2d6h odpowiada 2 dniom i 6 godzinom. Codziennie o północy każdy plik FFDC, który osiągnie maksymalny wiek, zostanie usunięty. Domyślnie pliki FFDC nie są usuwane na podstawie wieku pliku. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h) lub minuty (m). Na przykład określ 30 minut jako 30m. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1h30m oznacza 90 minut.
maxFileSize	int Minimum: 0	20	Maksymalna wielkość (w MB), jaką może osiągnąć plik dziennika, zanim zostanie zastąpiony. Środowisko wykonawcze serwera Liberty zastępuje dzienniki tylko na podstawie ich wielkości. Aby wyłączyć ten atrybut, ustaw jego wartość na 0. Maksymalna wielkość pliku jest podawana w przybliżeniu. Wartością domyślną jest 20. Uwaga: parametr maxFileSize nie dotyczy pliku console.log.
maxFiles	int Minimum: 0	2	Maksymalna liczba przechowywanych plików dziennika, zanim najstarszy plik zostaje usunięty. Wartość 0 oznacza brak limitu. Jeśli została wymuszona maksymalna wielkość pliku, to ustawienie jest używane do określenia liczby przechowywanych plików dziennika. To ustawienie ma zastosowanie również do liczby dzienników wyjątków zawierających podsumowanie wyjątków, które wystąpiły w danym dniu. Jeśli liczba ta wynosi 10, może istnieć 10 dzienników komunikatów, 10 dzienników śledzenia i 10 podsumowań wyjątków w katalogu ffdc/directory. Wartością domyślną jest 2. Uwaga: parametr maxFiles nie dotyczy pliku console.log.
messageFileName	string	messages.log	Nazwa pliku, w którym są zapisywane dane wyjściowe komunikatów względem skonfigurowanego katalogu dzienników. Wartość domyślna to messages.log. Ten plik zawsze istnieje i zawiera komunikaty INFO i inne (AUDIT, WARNING, ERROR, FAILURE) (podobnie jak pliki System.out i System.err). Ten dziennik zawiera również znaczniki czasu i identyfikator wątku, który zgłosił komunikaty. Jeśli plik dziennika jest zastępowany, nazwy wcześniejszych plików dziennika mają format messages_timestamp.log. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.message.file.name. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
messageFormat	JSON SIMPLE TBASIC	SIMPLE	Wymagany format pliku messages.log. Poprawne wartości to format SIMPLE lub JSON. Domyślnie atrybut messageFormat jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_MESSAGE_FORMAT (jeśli ją ustawiono) lub wartość SIMPLE. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_MESSAGE_FORMAT lub właściwości com.ibm.ws.logging.message.format. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu. JSON Użyj formatu JSON rejestrowania. SIMPLE Użyj prostego (SIMPLE) formatu rejestrowania. TBASIC Użyj formatu tbasic rejestrowania.
messageSource	string	message	Lista źródeł rozdzielonych przecinkami, które kierują dane do pliku messages.log. Ta właściwość ma zastosowanie tylko wtedy, gdy atrybut messageFormat=json. Poprawne wartości to: message, trace, accessLog, ffdc i audit. Domyślnie atrybut messageSource jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_MESSAGE_SOURCE (jeśli ją ustawiono) lub wartość message. Uwaga: Aby użyć źródła na poziomie audit, włącz funkcję kontroli Liberty. Włącz dzienniki dostępu, ustawiając element accessLogging dla punktu końcowego httpEndpoint. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_MESSAGE_SOURCE lub właściwości com.ibm.ws.logging.message.source. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
rolloverInterval	Okres z dokładnością do minuty	-1	Odstęp czasu między kolejnymi zastąpieniami dziennika w minutach, jeśli nie określono jednostki czasu. Podaj dodatnią liczbę całkowitą, po której następuje jednostka czasu, którą może być dzień (d), godzina (h) lub minuta (m). Na przykład, aby określić 5 godzin, wpisz 5h. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład wartość 1d5h oznacza 1 dzień i 5 godzin. Jeśli określona zostanie wartość parametru rolloverStartTime, wartość domyślna parametru rolloverInterval będzie wynosić 1 dzień. Jeśli zarówno parametr rolloverInterval, jak i rolloverStartTime nie zostaną określone, zastępowanie dziennika oparte na czasie będzie wyłączone. Uwaga: parametr rolloverInterval nie dotyczy pliku console.log. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h) lub minuty (m). Na przykład określ 30 minut jako 30m. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1h30m oznacza 90 minut.
rolloverStartTime	string		Zaplanowana godzina pierwszego zastąpienia dzienników. Przedział czasu zastąpienia rozpoczyna się w momencie rozpoczęcia zastąpienia. Poprawne wartości są zgodne z 24-godzinnym formatem ISO-8601 (GG:MM), gdzie 00:00 oznacza północ. Dopełnianie zerami jest wymagane. Jeśli określono parametr rolloverInterval, wartością domyślną rolloverStartTime jest 00:00 (północ). Jeśli zarówno parametr rolloverInterval, jak i rolloverStartTime nie zostaną określone, zastępowanie dziennika oparte na czasie będzie wyłączone. Uwaga: parametr rolloverStartTime nie dotyczy pliku console.log.
stackTraceSingleEntry	wartość boolowska	false	Obsługuj dane śledzenia stosu zapisane w pliku System.out/System.err jako pojedyncze zdarzenie w dziennikach.
suppressSensitiveTrace	wartość boolowska	false	Jeśli ten atrybut jest ustawiony na wartość true, zapobiega to umieszczaniu w plikach dziennika i śledzenia potencjalnie poufnych informacji. Wartość domyślna to false. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.suppress.sensitive.trace. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
traceFileName	string	trace.log	Nazwa pliku, w którym są zapisywane dane wyjściowe śledzenia względem skonfigurowanego katalogu dzienników. Wartość domyślna to trace.log. Plik trace.log jest tworzony tylko wtedy, gdy właściwość traceSpecification jest ustawiona w taki sposób, że zawiera poziomy rejestrowania poniżej poziomu INFO. Wartość stdout jest rozpoznawana jako wartość specjalna, która powoduje, że śledzenie jest kierowane do oryginalnego standardowego strumienia wyjściowego. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.trace.file.name. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
traceFormat	ADVANCED BASIC ENHANCED TBASIC	ENHANCED	Ten format jest używany dla dziennika śledzenia. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.trace.format. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu. ADVANCED Użyj zaawansowanego formatu śledzenia. BASIC Użyj podstawowego formatu śledzenia. ENHANCED Użyj rozszerzonego podstawowego formatu śledzenia. TBASIC Alias podstawowego formatu śledzenia.
traceSpecification	string	*=info	Specyfikacja śledzenia zgodna z gramatyką specyfikacji śledzenia, która określa początkowy stan różnych komponentów śledzenia. Specyfikacja śledzenia jest używana do selektywnego włączania śledzenia. Wartość pusta jest dozwolona i oznacza wyłączenie całego śledzenia. Każdy komponent, który nie został określony, jest inicjowany przy użyciu domyślnej wartości stanu *=info.

Nazwa

Typ

Wartość domyślna

Opis

appsWriteJson

wartość boolowska

false

Gdy dziennik komunikatów lub dziennik konsoli jest zapisany w formacie JSON, zezwalaj aplikacjom na zapis niezmodyfikowanych komunikatów w formacie JSON w tych miejscach docelowych.

consoleFormat

DEV
JSON
SIMPLE
TBASIC

DEV

Wymagany format konsoli. Poprawne wartości to format DEV, SIMPLE lub JSON. Domyślnie parametr consoleFormat jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_CONSOLE_FORMAT (jeśli ją ustawiono) lub wartość DEV. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_CONSOLE_FORMAT lub właściwości com.ibm.ws.logging.console.format. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
DEV
Użyj formatu DEV rejestrowania.
JSON
Użyj formatu JSON rejestrowania.
SIMPLE
Użyj prostego (SIMPLE) formatu rejestrowania.
TBASIC
Użyj formatu tbasic rejestrowania.

consoleLogLevel

AUDIT
ERROR
INFO
OFF
WARNING

AUDIT

Poziom rejestrowania używany w celu filtrowania komunikatów zapisywanych do strumieni systemowych. Poprawne wartości to INFO, AUDIT, WARNING, ERROR i OFF. Domyślnie właściwość consoleLogLevel jest ustawiona na wartość zmiennej środowiskowej WLP_LOGGING_CONSOLE_LOGLEVEL (jeśli ją ustawiono) lub wartość AUDIT. Uwaga: Przed zmianą tej wartości należy wziąć pod uwagę informacje zawarte w sekcji "Nie można wchodzić w interakcje z serwerem Liberty po zmodyfikowaniu ustawień poziomu rejestrowania danych z konsoli" tematu dotyczącego znanych ograniczeń narzędzi Developer Tools. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_CONSOLE_LOGLEVEL lub właściwości com.ibm.ws.logging.console.level. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
AUDIT
Komunikaty kontrolne i ostrzegawcze będą zapisywane do systemowego strumienia wyjściowego. Komunikaty o błędach będą zapisywane do systemowego strumienia błędów.
ERROR
Komunikaty o błędach będą zapisywane do systemowego strumienia błędów.
INFO
Komunikaty informacyjne, kontrolne i ostrzegawcze będą zapisywane do systemowego strumienia wyjściowego. Komunikaty o błędach będą zapisywane do systemowego strumienia błędów.
OFF
Wyjście serwera nie jest zapisywane do strumieni systemowych. Do strumieni systemowych jest zapisywane tylko wyjście maszyny JVM.
WARNING
Komunikaty ostrzegawcze będą zapisywane do systemowego strumienia wyjściowego. Komunikaty o błędach będą zapisywane do systemowego strumienia błędów.

consoleSource

string

message

Lista źródeł rozdzielonych przecinkami, które kierują dane do pliku console/console.log. Ta właściwość ma zastosowanie tylko wtedy, gdy atrybut consoleFormat=json. Poprawne wartości to: message, trace, accessLog, ffdc i audit. Domyślnie parametr consoleSource jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_CONSOLE_SOURCE (jeśli ją ustawiono) lub wartość message. Uwaga: Aby użyć źródła na poziomie audit, włącz funkcję kontroli Liberty. Włącz dzienniki dostępu, ustawiając element accessLogging dla punktu końcowego httpEndpoint. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_CONSOLE_SOURCE lub właściwości com.ibm.ws.logging.console.source. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

copySystemStreams

wartość boolowska

true

Jeśli właściwość ta ma wartość true, komunikaty zapisywane do strumieni System.out i System.err są kopiowane do pliku console.log. Jeśli ma ona wartość false, komunikaty są zapisywane w skonfigurowanych dziennikach, takich jak messages.log lub trace.log, ale nie są kopiowane do pliku console.log. Domyślną wartością jest true (prawda). Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.copy.system.streams. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

hideMessage

string

Rozdzielana przecinkami lista komunikatów, które są skonfigurowane do ukrycia w plikach console.log i messages.log. Jeśli komunikaty są skonfigurowane jako ukryte, są przekierowywane do pliku trace.log. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.hideMessage. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

isoDateFormat

wartość boolowska

false

Data i godzina są używane w formacie właściwym dla ustawień narodowych lub w formacie ISO-8601. Istnieje możliwość określenia wartości true lub false dla wartości tego atrybutu lub wartości odpowiedniej właściwości. Wartość domyślna to false. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.isoDateFormat. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu. Jeśli zostanie podana wartość true, w plikach messages.log i trace.log oraz w dziennikach FFDC będzie używany format ISO-8601. Format jest następujący: yyyy-MM-dd'T'HH:mm:ss.SSSZ. Jeśli zostanie podana wartość false, data i godzina zostaną sformatowane zgodnie z domyślnymi ustawieniami narodowymi systemu. Jeśli domyślne ustawienia narodowe nie zostaną znalezione, formatem będzie dd/MMM/yyyy HH:mm:ss:SSS z.

jsonAccessLogFields

default
logFormat

default

Gdy dzienniki są zapisywane w formacie JSON, za pomocą tego atrybutu można nakazać użycie pól dzienników dostępu określonych we właściwości logFormat konfiguracji accessLogging albo domyślnych pól dzienników dostępu.
default
Użyj domyślnego zestawu pól dzienników dostępu.
logFormat
Użyj zestawu pól dzienników dostępu zgodnego z logFormat.

jsonFieldMappings

string

Jeśli dzienniki są w formacie JSON, za pomocą tego atrybutu można zastąpić domyślne nazwy pól nowymi nazwami pól lub pominąć w dziennikach. Aby zastąpić nazwę pola, skonfiguruj nową nazwę przy użyciu następującego formatu: domyślna_nazwa_pola:nowa_nazwa_pola?. W przypadku nazw pól powiązanych z dziennikami określonego źródła, należy użyć formatu [źródło:]?domyślna_nazwa_pola:nowa_nazwa_pola, gdzie [źródło] oznacza określone źródło, np. message, trace lub accessLog. Aby pominąć pole w dziennikach, określ nazwę pola bez nazwy ją zastępującej, tak jak przedstawiono to w przykładzie: domyślna_nazwa_pola:. Aby zmienić nazwy wielu pól lub pominąć wiele pól, należy podać rozdzielaną przecinkami listę odwzorowań nazw pól.

logDirectory

Ścieżka do katalogu

${server.output.dir}/logs

Można użyć tego atrybutu do ustawienia katalogu dla wszystkich plików dziennika, z wyjątkiem pliku console.log, ale z uwzględnieniem pliku FFDC. Domyślnie parametr logDirectory jest ustawiony na zmienną środowiskową LOG_DIR. Domyślna ścieżka do zmiennej środowiskowej LOG_DIR to WLP_OUTPUT_DIR/serverName/logs. Aby uniknąć problemów, należy używać zmiennej środowiskowej LOG_DIR lub właściwości com.ibm.ws.logging.log.directory. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

maxFfdcAge

Okres z dokładnością do minuty

-1

Maksymalny oczekiwany wiek przed usunięciem pliku FFDC. Podaj dodatnią liczbę całkowitą, po której następuje jednostka czasu, którą może być dzień (d), godzina (h) lub minuta (m). Na przykład podaj 2 dni jako 2d. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład wartość 2d6h odpowiada 2 dniom i 6 godzinom. Codziennie o północy każdy plik FFDC, który osiągnie maksymalny wiek, zostanie usunięty. Domyślnie pliki FFDC nie są usuwane na podstawie wieku pliku. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h) lub minuty (m). Na przykład określ 30 minut jako 30m. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1h30m oznacza 90 minut.

maxFileSize

int
Minimum: 0

Maksymalna wielkość (w MB), jaką może osiągnąć plik dziennika, zanim zostanie zastąpiony. Środowisko wykonawcze serwera Liberty zastępuje dzienniki tylko na podstawie ich wielkości. Aby wyłączyć ten atrybut, ustaw jego wartość na 0. Maksymalna wielkość pliku jest podawana w przybliżeniu. Wartością domyślną jest 20. Uwaga: parametr maxFileSize nie dotyczy pliku console.log.

maxFiles

int
Minimum: 0

Maksymalna liczba przechowywanych plików dziennika, zanim najstarszy plik zostaje usunięty. Wartość 0 oznacza brak limitu. Jeśli została wymuszona maksymalna wielkość pliku, to ustawienie jest używane do określenia liczby przechowywanych plików dziennika. To ustawienie ma zastosowanie również do liczby dzienników wyjątków zawierających podsumowanie wyjątków, które wystąpiły w danym dniu. Jeśli liczba ta wynosi 10, może istnieć 10 dzienników komunikatów, 10 dzienników śledzenia i 10 podsumowań wyjątków w katalogu ffdc/directory. Wartością domyślną jest 2. Uwaga: parametr maxFiles nie dotyczy pliku console.log.

messageFileName

string

messages.log

Nazwa pliku, w którym są zapisywane dane wyjściowe komunikatów względem skonfigurowanego katalogu dzienników. Wartość domyślna to messages.log. Ten plik zawsze istnieje i zawiera komunikaty INFO i inne (AUDIT, WARNING, ERROR, FAILURE) (podobnie jak pliki System.out i System.err). Ten dziennik zawiera również znaczniki czasu i identyfikator wątku, który zgłosił komunikaty. Jeśli plik dziennika jest zastępowany, nazwy wcześniejszych plików dziennika mają format messages_timestamp.log. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.message.file.name. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

messageFormat

JSON
SIMPLE
TBASIC

SIMPLE

Wymagany format pliku messages.log. Poprawne wartości to format SIMPLE lub JSON. Domyślnie atrybut messageFormat jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_MESSAGE_FORMAT (jeśli ją ustawiono) lub wartość SIMPLE. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_MESSAGE_FORMAT lub właściwości com.ibm.ws.logging.message.format. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
JSON
Użyj formatu JSON rejestrowania.
SIMPLE
Użyj prostego (SIMPLE) formatu rejestrowania.
TBASIC
Użyj formatu tbasic rejestrowania.

messageSource

string

message

Lista źródeł rozdzielonych przecinkami, które kierują dane do pliku messages.log. Ta właściwość ma zastosowanie tylko wtedy, gdy atrybut messageFormat=json. Poprawne wartości to: message, trace, accessLog, ffdc i audit. Domyślnie atrybut messageSource jest ustawiony na wartość zmiennej środowiskowej WLP_LOGGING_MESSAGE_SOURCE (jeśli ją ustawiono) lub wartość message. Uwaga: Aby użyć źródła na poziomie audit, włącz funkcję kontroli Liberty. Włącz dzienniki dostępu, ustawiając element accessLogging dla punktu końcowego httpEndpoint. Aby uniknąć problemów, należy używać zmiennej środowiskowej WLP_LOGGING_MESSAGE_SOURCE lub właściwości com.ibm.ws.logging.message.source. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

rolloverInterval

Okres z dokładnością do minuty

-1

Odstęp czasu między kolejnymi zastąpieniami dziennika w minutach, jeśli nie określono jednostki czasu. Podaj dodatnią liczbę całkowitą, po której następuje jednostka czasu, którą może być dzień (d), godzina (h) lub minuta (m). Na przykład, aby określić 5 godzin, wpisz 5h. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład wartość 1d5h oznacza 1 dzień i 5 godzin. Jeśli określona zostanie wartość parametru rolloverStartTime, wartość domyślna parametru rolloverInterval będzie wynosić 1 dzień. Jeśli zarówno parametr rolloverInterval, jak i rolloverStartTime nie zostaną określone, zastępowanie dziennika oparte na czasie będzie wyłączone. Uwaga: parametr rolloverInterval nie dotyczy pliku console.log. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h) lub minuty (m). Na przykład określ 30 minut jako 30m. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1h30m oznacza 90 minut.

rolloverStartTime

string

Zaplanowana godzina pierwszego zastąpienia dzienników. Przedział czasu zastąpienia rozpoczyna się w momencie rozpoczęcia zastąpienia. Poprawne wartości są zgodne z 24-godzinnym formatem ISO-8601 (GG:MM), gdzie 00:00 oznacza północ. Dopełnianie zerami jest wymagane. Jeśli określono parametr rolloverInterval, wartością domyślną rolloverStartTime jest 00:00 (północ). Jeśli zarówno parametr rolloverInterval, jak i rolloverStartTime nie zostaną określone, zastępowanie dziennika oparte na czasie będzie wyłączone. Uwaga: parametr rolloverStartTime nie dotyczy pliku console.log.

stackTraceSingleEntry

wartość boolowska

false

Obsługuj dane śledzenia stosu zapisane w pliku System.out/System.err jako pojedyncze zdarzenie w dziennikach.

suppressSensitiveTrace

wartość boolowska

false

Jeśli ten atrybut jest ustawiony na wartość true, zapobiega to umieszczaniu w plikach dziennika i śledzenia potencjalnie poufnych informacji. Wartość domyślna to false. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.suppress.sensitive.trace. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

traceFileName

string

trace.log

Nazwa pliku, w którym są zapisywane dane wyjściowe śledzenia względem skonfigurowanego katalogu dzienników. Wartość domyślna to trace.log. Plik trace.log jest tworzony tylko wtedy, gdy właściwość traceSpecification jest ustawiona w taki sposób, że zawiera poziomy rejestrowania poniżej poziomu INFO. Wartość stdout jest rozpoznawana jako wartość specjalna, która powoduje, że śledzenie jest kierowane do oryginalnego standardowego strumienia wyjściowego. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.trace.file.name. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.

traceFormat

ADVANCED
BASIC
ENHANCED
TBASIC

ENHANCED

Ten format jest używany dla dziennika śledzenia. Aby uniknąć problemów, należy używać właściwości com.ibm.ws.logging.trace.format. Wyjątkiem są przypadki, w których podejmowana jest próba dynamicznej zmiany konfiguracji po uruchomieniu.
ADVANCED
Użyj zaawansowanego formatu śledzenia.
BASIC
Użyj podstawowego formatu śledzenia.
ENHANCED
Użyj rozszerzonego podstawowego formatu śledzenia.
TBASIC
Alias podstawowego formatu śledzenia.

traceSpecification

string

*=info

Specyfikacja śledzenia zgodna z gramatyką specyfikacji śledzenia, która określa początkowy stan różnych komponentów śledzenia. Specyfikacja śledzenia jest używana do selektywnego włączania śledzenia. Wartość pusta jest dozwolona i oznacza wyłączenie całego śledzenia. Każdy komponent, który nie został określony, jest inicjowany przy użyciu domyślnej wartości stanu *=info.

binaryLog

Opcje rejestrowania binarnego. Dziennik binarny można wyświetlić przy użyciu komendy logViewer.

Nazwa	Typ	Wartość domyślna	Opis
bufferingEnabled	wartość boolowska	true	Określa, czy w celu uzyskania lepszej wydajności rekordy mogą być zapisywane na dysku z niewielkim opóźnieniem. Jeśli atrybut bufferingEnabled jest ustawiony na wartość true, rekordy będą przechowywane w pamięci przez krótki czas, zanim zostaną zapisane na dysku.
fileSwitchTime	int Minimum: 0 Maksimum: 23		Powoduje, że serwer zamyka aktywny plik dziennika i rozpoczyna nowy plik o określonej godzinie. Jeśli atrybut fileSwitchTime jest określony, przełączanie plików jest włączone. W przeciwnym razie jest ono wyłączone.
outOfSpaceAction	PurgeOld StopLogging StopServer	StopLogging	Określa działanie, jakie ma zostać wykonane w przypadku braku wolnego miejsca w systemie plików, w którym są przechowywane rekordy. Jeśli atrybut outOfSpaceAction ma wartość StopLogging, serwer zatrzyma rejestrowanie, gdy nie będzie można zapisać rekordów na dysku. Jeśli ten atrybut ma wartość PurgeOld, serwer wykona próbę usunięcia najstarszych rekordów z repozytorium dziennika binarnego, aby zrobić miejsce na nowe rekordy. Jeśli ten atrybut ma wartość StopServer, dziennik binarny zatrzyma serwer, gdy nie będzie można zapisać rekordów. PurgeOld Usuń stare rekordy StopLogging Zatrzymaj rejestrowanie StopServer Zatrzymaj serwer
purgeMaxSize	int Minimum: 0	50	Określa maksymalną wielkość repozytorium dziennika binarnego w megabajtach. Jeśli atrybut purgeMaxSize jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wielkości repozytorium jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu.
purgeMinTime	Okres z dokładnością do godziny	0	Określa czas w godzinach, po którym serwer może usunąć rekord dziennika. Jeśli atrybut purgeMinTime jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wieku rekordu dziennika jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h). Na przykład określ 12 godzin jako 12h.

Nazwa

Typ

Wartość domyślna

Opis

bufferingEnabled

wartość boolowska

true

Określa, czy w celu uzyskania lepszej wydajności rekordy mogą być zapisywane na dysku z niewielkim opóźnieniem. Jeśli atrybut bufferingEnabled jest ustawiony na wartość true, rekordy będą przechowywane w pamięci przez krótki czas, zanim zostaną zapisane na dysku.

fileSwitchTime

int
Minimum: 0
Maksimum: 23

Powoduje, że serwer zamyka aktywny plik dziennika i rozpoczyna nowy plik o określonej godzinie. Jeśli atrybut fileSwitchTime jest określony, przełączanie plików jest włączone. W przeciwnym razie jest ono wyłączone.

outOfSpaceAction

PurgeOld
StopLogging
StopServer

StopLogging

Określa działanie, jakie ma zostać wykonane w przypadku braku wolnego miejsca w systemie plików, w którym są przechowywane rekordy. Jeśli atrybut outOfSpaceAction ma wartość StopLogging, serwer zatrzyma rejestrowanie, gdy nie będzie można zapisać rekordów na dysku. Jeśli ten atrybut ma wartość PurgeOld, serwer wykona próbę usunięcia najstarszych rekordów z repozytorium dziennika binarnego, aby zrobić miejsce na nowe rekordy. Jeśli ten atrybut ma wartość StopServer, dziennik binarny zatrzyma serwer, gdy nie będzie można zapisać rekordów.
PurgeOld
Usuń stare rekordy
StopLogging
Zatrzymaj rejestrowanie
StopServer
Zatrzymaj serwer

purgeMaxSize

int
Minimum: 0

Określa maksymalną wielkość repozytorium dziennika binarnego w megabajtach. Jeśli atrybut purgeMaxSize jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wielkości repozytorium jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu.

purgeMinTime

Okres z dokładnością do godziny

Określa czas w godzinach, po którym serwer może usunąć rekord dziennika. Jeśli atrybut purgeMinTime jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wieku rekordu dziennika jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h). Na przykład określ 12 godzin jako 12h.

binaryTrace

Opcje śledzenia binarnego. Dane śledzenia binarnego można wyświetlić przy użyciu komendy logViewer.

Nazwa	Typ	Wartość domyślna	Opis
bufferingEnabled	wartość boolowska	true	Określa, czy w celu uzyskania lepszej wydajności rekordy mogą być zapisywane na dysku z niewielkim opóźnieniem. Jeśli atrybut bufferingEnabled jest ustawiony na wartość true, rekordy będą przechowywane w pamięci przez krótki czas, zanim zostaną zapisane na dysku.
fileSwitchTime	int Minimum: 0 Maksimum: 23		Powoduje, że serwer zamyka aktywny plik śledzenia i rozpoczyna nowy plik o określonej godzinie. Jeśli atrybut fileSwitchTime jest określony, przełączanie plików jest włączone. W przeciwnym razie jest ono wyłączone.
outOfSpaceAction	PurgeOld StopLogging StopServer	StopLogging	Określa działanie, jakie ma zostać wykonane w przypadku braku wolnego miejsca w systemie plików, w którym są przechowywane rekordy. Jeśli atrybut outOfSpaceAction ma wartość StopLogging, serwer zatrzyma śledzenie, gdy nie będzie można zapisać rekordów na dysku. Jeśli ten atrybut ma wartość PurgeOld, serwer wykona próbę usunięcia najstarszych rekordów z repozytorium śledzenia binarnego, aby zrobić miejsce na nowe rekordy. Jeśli ten atrybut ma wartość StopServer, funkcja śledzenia binarnego zatrzyma serwer, gdy nie będzie można zapisać rekordów. PurgeOld Usuń stare rekordy StopLogging Zatrzymaj rejestrowanie StopServer Zatrzymaj serwer
purgeMaxSize	int Minimum: 0	50	Określa maksymalną wielkość repozytorium śledzenia binarnego w megabajtach. Jeśli atrybut purgeMaxSize jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wielkości repozytorium jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu.
purgeMinTime	Okres z dokładnością do godziny	0	Określa czas w godzinach, po którym serwer może usunąć rekord śledzenia. Jeśli atrybut purgeMinTime jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wieku rekordu śledzenia jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h). Na przykład określ 12 godzin jako 12h.

Nazwa

Typ

Wartość domyślna

Opis

bufferingEnabled

wartość boolowska

true

fileSwitchTime

int
Minimum: 0
Maksimum: 23

Powoduje, że serwer zamyka aktywny plik śledzenia i rozpoczyna nowy plik o określonej godzinie. Jeśli atrybut fileSwitchTime jest określony, przełączanie plików jest włączone. W przeciwnym razie jest ono wyłączone.

outOfSpaceAction

PurgeOld
StopLogging
StopServer

StopLogging

Określa działanie, jakie ma zostać wykonane w przypadku braku wolnego miejsca w systemie plików, w którym są przechowywane rekordy. Jeśli atrybut outOfSpaceAction ma wartość StopLogging, serwer zatrzyma śledzenie, gdy nie będzie można zapisać rekordów na dysku. Jeśli ten atrybut ma wartość PurgeOld, serwer wykona próbę usunięcia najstarszych rekordów z repozytorium śledzenia binarnego, aby zrobić miejsce na nowe rekordy. Jeśli ten atrybut ma wartość StopServer, funkcja śledzenia binarnego zatrzyma serwer, gdy nie będzie można zapisać rekordów.
PurgeOld
Usuń stare rekordy
StopLogging
Zatrzymaj rejestrowanie
StopServer
Zatrzymaj serwer

purgeMaxSize

int
Minimum: 0

Określa maksymalną wielkość repozytorium śledzenia binarnego w megabajtach. Jeśli atrybut purgeMaxSize jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wielkości repozytorium jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu.

purgeMinTime

Okres z dokładnością do godziny

Określa czas w godzinach, po którym serwer może usunąć rekord śledzenia. Jeśli atrybut purgeMinTime jest określony przy użyciu wartości większej niż 0, czyszczenie na podstawie wieku rekordu śledzenia jest włączone. W przeciwnym razie jest ono wyłączone. Wartość 0 oznacza brak limitu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h). Na przykład określ 12 godzin jako 12h.