10.5. 로그 처리기 구성
로그 처리기는 캡처된 로그 메시지가 기록되는 방식을 정의합니다.
특정 로그 처리기를 구성하려면 적절한 섹션을 참조하십시오.
10.5.1. 콘솔 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 콘솔 로그 처리기를 구성할 수 있습니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > Console Handler 를 선택하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 콘솔 로그 처리기를 구성할 수 있습니다.
- 새 콘솔 로그 처리기 추가
- 콘솔 로그 처리기 설정 구성
- 로거에 콘솔 로그 처리기 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 콘솔 로그 처리기를 추가합니다.
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:add요구 사항에 따라 다음 콘솔 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 처리기의 대상을 설정합니다.
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=target,value=TARGET)대상은
System.out,System.err또는console일 수 있습니다. 기본값은System.out입니다.다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 처리기의 formatter 문자열을 설정합니다.
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)예를 들어 기본 형식 문자열은
%d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n입니다.FORMAT값을 따옴표로 묶습니다.참고저장된 포맷터를 참조하려면
named-formatter속성을 사용합니다.다음 명령을 사용하여 자동 플러시를 설정합니다.
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)각 쓰기 후 자동으로 플러시할지 여부를 지정합니다. 기본값은
true입니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 콘솔 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=CONSOLE_HANDLER_NAME)로그 처리기를 활성화하려면 콘솔 로그 처리기를 루트 로거 또는 기타 로거에 할당할 수 있습니다.
필요한 경우 다음 명령에서
remove작업을 사용하여 로그 처리기를 제거할 수 있습니다./subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
다음 단계
10.5.2. 파일 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 파일 로그 처리기를 구성할 수 있습니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > File Handler 를 선택하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 파일 로그 처리기를 구성할 수 있습니다.
- 새 파일 로그 처리기 추가
- 파일 로그 처리기 설정 구성
- 로거에 파일 로그 처리기 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 파일 로그 처리기를 추가합니다.
/subsystem=logging/file-handler=FILE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})참고파일 로그 처리기를 추가할 때 경로 및
relative-to속성으로 구성된file속성을 사용하여 파일경로를지정합니다.경로속성을 사용하여 파일 이름(예:my-log.log)을 포함하여 로그 파일 경로를 설정합니다. 선택적으로relative-to특성을 사용하여 경로가jboss.server.log.dir과 같은 이름이 지정된 경로와 상대적임을 나타냅니다.요구 사항에 따라 다음 파일 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 처리기의 추가 동작을 설정합니다.
/subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=append,value=APPEND)append속성을false로 설정하여 서버를 다시 시작할 때 파일을 덮어씁니다. 기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다.다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 처리기의 formatter 문자열을 설정합니다.
/subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)예를 들어 기본 형식 문자열은
%d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n입니다.FORMAT값을 따옴표로 묶습니다.참고저장된 포맷터를 참조하려면
named-formatter속성을 사용합니다.다음 명령을 사용하여 자동 플러시를 설정합니다.
/subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)각 쓰기 후 자동으로 플러시할지 여부를 지정합니다. 기본값은
true입니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 파일 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=FILE_HANDLER_NAME)로그 처리기를 활성화하려면 파일 로그 처리기를 루트 로거 또는 기타 로거에 할당할 수 있습니다.
다음 명령을 사용하여
CATEGORY라는 특정 로거에 파일 로그 처리기를 할당합니다./subsystem=logging/logger=CATEGORY:add-handler(name=FILE_HANDLER_NAME)CATEGORY를 파일 로그 처리기를 할당할 로거 이름으로 교체합니다.필요한 경우 다음 명령에서
remove작업을 사용하여 로그 처리기를 제거할 수 있습니다./subsystem=logging/file-handler=FILE_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
10.5.3. 주기적 회전 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 주기적인 회전 로그 처리기를 구성할 수 있습니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > Periodic Handler 를 선택하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 주기적 회전 로그 처리기를 구성할 수 있습니다.
- 주기적인 회전 로그 처리기 추가
- 주기적인 회전 로그 처리기 설정 구성
- 주기적으로 로그 처리기를 로거에 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 주기적인 회전 로그 처리기를 추가합니다.
/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)참고주기적인 회전 로그 처리기를 추가할 때 경로 및
relative-to속성으로 구성된file속성을 사용하여 파일경로를지정합니다.경로속성을 사용하여 파일 이름(예:my-log.log)을 포함하여 로그 파일 경로를 설정합니다. 선택적으로relative-to특성을 사용하여 경로가jboss.server.log.dir과 같은 이름이 지정된 경로와 상대적임을 나타냅니다.접미사 특성을 사용하여 순환된 로그의
접미사를 설정해야 합니다. 접미사는.yyyy-MM-dd-HH와 같이java.text.SimpleDateFormat에서 이해할 수 있는 형식을 따라야 합니다. 순환 기간은 이 접미사에 따라 자동으로 계산됩니다.요구 사항에 따라 다음 주기적 회전 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 처리기의 추가 동작을 설정합니다.
/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=append,value=APPEND)append속성을false로 설정하여 서버를 다시 시작할 때 파일을 덮어씁니다. 기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다.다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 처리기의 formatter 문자열을 설정합니다.
/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)예를 들어 기본 형식 문자열은
%d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n입니다.FORMAT값을 따옴표로 묶습니다.참고저장된 포맷터를 참조하려면
named-formatter속성을 사용합니다.다음 명령을 사용하여 자동 플러시를 설정합니다.
/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)각 쓰기 후 자동으로 플러시할지 여부를 지정합니다. 기본값은
true입니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 주기적으로 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_HANDLER_NAME)로그 처리기를 활성화하려면 주기적인 회전 로그 처리기를 루트 로거 또는 기타 로거에 할당할 수 있습니다.
필요한 경우 다음 명령에서
remove작업을 사용하여 로그 처리기를 제거할 수 있습니다./subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
다음 단계
10.5.4. 크기 회전 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 크기 로그 처리기를 구성할 수 있습니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > Size Handler 를 선택하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 크기 로그 처리기를 구성할 수 있습니다.
- 새 크기 로그 처리기 추가
- 크기 로그 처리기 설정 구성
- 로거에 크기 로그 처리기 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 크기 로그 처리기를 추가합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})참고크기 로그 처리기를 추가할 때 경로 및
relative-to속성으로 구성된file특성을 사용하여 파일경로를지정합니다.경로속성을 사용하여 파일 이름(예:my-log.log)을 포함하여 로그 파일 경로를 설정합니다. 선택적으로relative-to특성을 사용하여 경로가jboss.server.log.dir과 같은 이름이 지정된 경로와 상대적임을 나타냅니다.요구 사항에 따라 다음 크기 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 순환된 로그의 접미사를 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=suffix, value=SUFFIX)참고지정된 경우 접미사는
.yyyy-MM-dd-HH와 같이java.text.SimpleDateFormat에서 이해할 수 있는 형식을 따라야 합니다.size-rotating-file-handler의 접미사는 선택 사항입니다. 파일이 순환된 시기가 아니라 순환 기간 자체를 나타냅니다.다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/size-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 회전 크기를 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)회전하기 전에 최대 파일 크기를 설정합니다. 기본값은 2MB의 경우
2m입니다.다음 명령을 사용하여 유지할 최대 백업 로그 수를 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)유지할 백업 수를 지정합니다. 기본값은
1입니다.참고교체는 접미사가 아닌 크기 제한에 따라 수행됩니다. 접미사가 정의되면 순환된 파일에 추가되지만 해당 파일은 삭제되지 않습니다. 크기 제한에 도달하는 파일만 순환 중에 삭제됩니다.
다음 명령을 사용하여 부팅 시 로그를 회전할지 여부를 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)기본적으로 서버를 다시 시작할 때 새 로그 파일이 생성되지 않습니다. 서버를 다시 시작할 때 로그를 교체하려면
true로 설정합니다.다음 명령을 사용하여 처리기의 추가 동작을 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)append속성을false로 설정하여 서버를 다시 시작할 때 파일을 덮어씁니다. 기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다.다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 처리기의 formatter 문자열을 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)예를 들어 기본 형식 문자열은
%d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n입니다.FORMAT값을 따옴표로 묶습니다.참고저장된 포맷터를 참조하려면
named-formatter속성을 사용합니다.다음 명령을 사용하여 자동 플러시를 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)각 쓰기 후 자동으로 플러시할지 여부를 지정합니다. 기본값은
true입니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 크기 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=SIZE_HANDLER_NAME)로그 처리기를 활성화하려면 루트 로거 또는 기타 로거에 크기 로그 처리기를 할당할 수 있습니다.
필요한 경우 다음 명령에서
remove작업을 사용하여 로그 처리기를 제거할 수 있습니다./subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
다음 단계
10.5.5. 주기적인 크기 회전 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 주기적인 크기 회전 로그 처리기를 구성할 수 있습니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > Periodic Size Handler 로 이동하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 주기적인 크기 로그 처리기를 구성할 수 있습니다.
- 주기적인 크기 로그 처리기 추가
- 주기적인 크기 로그 처리기 설정 구성
- 주기적인 크기 로그 처리기를 로거에 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 주기적인 크기 로그 처리기를 추가합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)참고주기적인 크기 로그 처리기를 추가할 때 경로 및
relative-to속성으로 구성된file속성을 사용하여 파일경로를지정합니다.경로속성을 사용하여 파일 이름(예:my-log.log)을 포함하여 로그 파일 경로를 설정합니다. 선택적으로relative-to특성을 사용하여 경로가jboss.server.log.dir과 같은 이름이 지정된 경로와 상대적임을 나타냅니다.접미사 특성을 사용하여 순환된 로그의
접미사를 설정해야 합니다. 접미사는.yyyy-MM-dd-HH와 같이java.text.SimpleDateFormat에서 이해할 수 있는 형식을 따라야 합니다. 순환 기간은 이 접미사에 따라 자동으로 계산됩니다.필요에 따라 다음 주기 크기 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 회전 크기를 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)회전하기 전에 최대 파일 크기를 설정합니다. 기본값은 2MB의 경우
2m입니다.다음 명령을 사용하여 유지할 최대 백업 로그 수를 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)유지할 백업 수를 지정합니다. 기본값은
1입니다.참고접미사로 순환하면 순환된 파일이 삭제되지 않습니다. 순환 시 크기 제한에 도달하는 파일만 순환 중에 삭제됩니다.
다음 명령을 사용하여 부팅 시 로그를 회전할지 여부를 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)기본적으로 서버를 다시 시작할 때 새 로그 파일이 생성되지 않습니다. 서버를 다시 시작할 때 로그를 교체하려면
true로 설정합니다.다음 명령을 사용하여 처리기의 추가 동작을 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)append속성을false로 설정하여 서버를 다시 시작할 때 파일을 덮어씁니다. 기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다.다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 처리기의 formatter 문자열을 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)예를 들어 기본 형식 문자열은
%d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n입니다.FORMAT값을 따옴표로 묶습니다.참고저장된 포맷터를 참조하려면
named-formatter속성을 사용합니다.다음 명령을 사용하여 자동 플러시를 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)각 쓰기 후 자동으로 플러시할지 여부를 지정합니다. 기본값은
true입니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 주기적인 크기 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)로그 처리기를 활성화하려면 주기적인 크기 로그 처리기를 루트 로거 또는 기타 로거에 할당할 수 있습니다.
필요한 경우 다음 명령에서
remove작업을 사용하여 로그 처리기를 제거할 수 있습니다./subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
다음 단계
10.5.6. syslog 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 syslog 처리기를 구성할 수 있습니다. 이 처리기는 RFC-3164 또는 RFC-5424 중 하나인 Syslog 프로토콜을 지원하는 원격 로깅 서버로 메시지를 보냅니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > Syslog Handler 를 선택하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 syslog 처리기를 구성할 수 있습니다.
- 새 syslog 처리기 추가
- syslog 처리기 설정 구성
- 로거에 syslog 처리기 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 syslog 처리기를 추가합니다.
/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:add요구 사항에 따라 다음 syslog 처리기 속성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 로깅할 애플리케이션 이름을 설정합니다.
/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=app-name,value=APP_NAME)기본 애플리케이션 이름은
java입니다.다음 명령을 사용하여 syslog 서버의 주소를 설정합니다.
/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=server-address,value=SERVER_ADDRESS)기본 주소는
localhost입니다.다음 명령을 사용하여 syslog 서버의 포트를 설정합니다.
/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=port,value=PORT)기본 포트는
514입니다.다음 명령을 사용하여 RFC 사양에 따라 syslog 형식을 설정합니다.
/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=syslog-format,value=SYSLOG_FORMAT)기본 형식은
RFC5424입니다.다음 명령을 사용하여 syslog 페이로드 메시지를 포맷하려면
named-formatter속성을 지정합니다./subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=named-formatter, value=FORMATTER_NAME)
다음 명령을 사용하여 syslog 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=SYSLOG_HANDLER_NAME)로그 처리기를 활성화하려면 syslog 처리기를 루트 로거 또는 기타 로거에 할당할 수 있습니다.
필요한 경우 다음 명령에서
remove작업을 사용하여 로그 처리기를 제거할 수 있습니다./subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
다음 단계
10.5.7. 소켓 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 소켓 로그 처리기를 구성할 수 있습니다. 처리기는 TCP 또는 UDP 소켓을 통해 메시지를 보냅니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > Socket Handler 를 선택하여 관리 콘솔을 통해 구성할 수 있습니다.
서버가 관리자 전용 모드에서 시작되면 로그 메시지를 삭제합니다.
다음 작업을 수행하여 소켓 로그 처리기를 구성할 수 있습니다.
- 소켓 바인딩 추가
- 로그 포맷터 추가
- 소켓 로그 처리기 추가
- 설정 구성
- 소켓 로그 처리기를 로거에 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 소켓 바인딩을 추가합니다.
/socket-binding-group=SOCKET_BINDING_GROUP/remote-destination-outbound-socket-binding=SOCKET_BINDING_NAME:add(host=HOST, port=PORT)참고사용할 소켓 바인딩으로
remote-destination-outbound-socket-binding또는local-destination-outbound-socket-binding을 정의할 수 있습니다. ???다음 명령을 사용하여 JSON 포맷터와 같이 사용할 로그 포맷터를 추가합니다.
/subsystem=logging/json-formatter=FORMATTER:add다음 명령을 사용하여 사용할 소켓 바인딩 및 포맷터를 지정하여 소켓 로그 처리기를 추가합니다.
/subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:add(outbound-socket-binding-ref=SOCKET_BINDING_NAME,named-formatter=FORMATTER)요구 사항에 따라 다음 소켓 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 프로토콜을 설정합니다.
/subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=protocol,value=PROTOCOL)기본 프로토콜은
TCP입니다.다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.참고서버를 시작하는 동안 소켓 로그 처리기에서 처리하는 로그 메시지는 소켓 바인딩이 구성되고
로깅하위 시스템이 초기화될 때까지 큐에 추가됩니다.TRACE또는DEBUG와 같이 로그 수준을 낮게 설정하면 시작 중에 메모리 사용량이 크게 증가할 수 있습니다.다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 자동 플러시를 설정합니다.
/subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)각 쓰기 후 자동으로 플러시할지 여부를 지정합니다. 기본값은
true입니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 소켓 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=SOCKET_HANDLER_NAME)로그 처리기를 활성화하려면 소켓 로그 처리기를 루트 로거 또는 기타 로거에 할당할 수 있습니다.
필요한 경우 다음 명령과 함께
remove작업을 사용하여 소켓 로그 처리기를 제거할 수 있습니다./subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
다음 단계
10.5.7.1. SSL/TLS를 통해 소켓 로그 메시지 전송 링크 복사링크가 클립보드에 복사되었습니다!
SSL_TCP 프로토콜을 사용하여 소켓을 통해 로그 메시지를 보내도록 소켓 로그 처리기를 설정할 수 있습니다. 이 설정은 키 저장소, 신뢰 관리자 및 클라이언트 SSL 컨텍스트를 포함하여 elytron 하위 시스템에서 주요 구성 요소를 구성해야 합니다. 이 구성을 사용하면 JSON 포맷터로 포맷된 메시지를 사용하여 지정된 소켓을 통해 루트 로거에서 로그 메시지를 안전하게 전송할 수 있습니다.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
프로세스
다음 단계를 수행하여 Elytron 설정을 구성합니다.
다음 명령을 사용하여 키 저장소를 추가합니다.
/subsystem=elytron/key-store=log-server-ks:add(path=/path/to/keystore.jks, type=JKS, credential-reference={clear-text=mypassword})다음 명령을 사용하여 신뢰 관리자를 추가합니다.
/subsystem=elytron/trust-manager=log-server-tm:add(key-store=log-server-ks)다음 명령을 사용하여 클라이언트 SSL 컨텍스트를 추가합니다.
/subsystem=elytron/client-ssl-context=log-server-context:add(trust-manager=log-server-tm, protocols=["TLSv1.2"])
다음 명령을 사용하여 소켓 바인딩을 추가합니다.
/socket-binding-group=standard-sockets/remote-destination-outbound-socket-binding=log-server:add(host=localhost, port=4560)다음 명령을 사용하여 JSON 포맷터를 추가합니다.
/subsystem=logging/json-formatter=json:add다음 명령을 사용하여 소켓 로그 처리기를 추가합니다.
/subsystem=logging/socket-handler=log-server-handler:add(named-formatter=json, level=INFO, outbound-socket-binding-ref=log-server, protocol=SSL_TCP, ssl-context=log-server-context)다음 명령을 사용하여 로그 처리기를 루트 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=log-server-handler)
10.5.8. 사용자 정의 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 사용자 지정 로그 처리기를 구성할 수 있습니다. 또는 Configuration > Cryostats > Logging > Configuration, View 를 클릭하고 Handler > Custom Handler 를 선택하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 사용자 정의 로그 처리기를 구성할 수 있습니다.
- 새 사용자 정의 로그 처리기 추가
- 사용자 정의 로그 처리기 설정 구성
- 로거에 사용자 정의 로그 처리기 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 사용자 정의 로그 처리기를 추가합니다.
/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:add(class=CLASS_NAME,module=MODULE_NAME)참고사용자 지정 로그 처리기를 추가할 때 처리기의 Java 클래스와 이를 포함하는 JBoss EAP 모듈을 지정합니다. 클래스는
java.util.logging.Handler를 확장해야 합니다.사용자 지정 로거 가 포함된 모듈을 생성 했는지 확인합니다. 그렇지 않으면 이 명령이 실패합니다.
요구 사항에 따라 다음 사용자 정의 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 로그 처리기의 속성을 설정합니다.
/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=properties.PROPERTY_NAME,value=PROPERTY_VALUE)속성은 setter 방법을 사용하여 액세스할 수 있어야 합니다.
다음 명령을 사용하여 처리기의 인코딩(예:
utf-8)을 설정합니다./subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)다음 명령을 사용하여 처리기의 formatter 문자열을 설정합니다.
/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)예를 들어 기본 형식 문자열은
%d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n입니다.FORMAT값을 따옴표로 묶습니다.참고저장된 포맷터를 참조하려면
named-formatter속성을 사용합니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 사용자 정의 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=CUSTOM_HANDLER_NAME)로그 처리기를 활성화하려면 루트 로거 또는 기타 로거에 핸들러를 할당할 수 있습니다.
다음 명령을 사용하여 사용자 정의 로그 처리기를
CATEGORY라는 특정 로거에 할당합니다./subsystem=logging/logger=CATEGORY:add-handler(name=CUSTOM_HANDLER_NAME)CATEGORY를 사용자 정의 로그 처리기를 할당하려는 로거 이름으로 교체합니다.필요한 경우 다음 명령과 함께
remove작업을 사용하여 사용자 정의 로그 처리기를 제거할 수 있습니다./subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다.
다음 단계
10.5.9. 비동기 로그 처리기 구성 링크 복사링크가 클립보드에 복사되었습니다!
관리 CLI를 사용하여 JBoss EAP에서 async 로그 처리기를 구성할 수 있습니다. 또는 구성 > Logging > Configuration , View 를 클릭하고 Handler > Async Handler 로 이동하여 관리 콘솔을 통해 구성할 수 있습니다.
다음 작업을 수행하여 async 로그 처리기를 구성할 수 있습니다.
- 새 async 로그 처리기 추가
- async 로그 처리기에 하위 핸들러 추가
- async 로그 처리기 설정 구성
- 로거에 async 로그 처리기 할당
로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 으로 명령을 시작합니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사전 요구 사항
- JBoss EAP가 실행 중입니다.
- 관리 CLI에 액세스할 수 있습니다.
프로세스
다음 명령을 사용하여 async 로그 처리기를 추가합니다.
/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add(queue-length=QUEUE_LENGTH)참고비동기 로그 처리기를 추가할 때 언제든지 큐에 보관할 수 있는 최대 로그 요청 수인 큐 길이를 지정합니다.
다음 명령을 사용하여 하위 핸들러를 추가합니다.
/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add-handler(name=HANDLER_NAME)참고이 비동기 로그 처리기의 하위 핸들러로 하나 이상의 처리기를 추가할 수 있습니다. 처리기가 구성에 이미 있어야 합니다. 그렇지 않으면 이 명령이 실패합니다.
요구 사항에 따라 다음 async 로그 처리기 특성 중 하나 이상을 설정할 수 있습니다.
다음 명령을 사용하여 처리기의 로그 수준을 설정합니다.
/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=level,value=LEVEL)기본값은
ALL입니다.다음 명령을 사용하여 오버플로 작업을 설정합니다.
/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=overflow-action,value=OVERFLOW_ACTION)기본값은
BLOCK입니다. 즉, 큐가 가득 차면 스레드가 차단됩니다. 이 값을DISCARD로 변경할 수 있습니다. 즉, 전체 대기열의 경우 새 메시지를 수용하기 위해 가장 오래된 로그 메시지가 삭제됩니다.다음 명령을 사용하여 필터 표현식을 설정합니다.
/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)처리기에 대한 로그 메시지를 필터링할 표현식을 지정합니다. 쉼표와 따옴표를 이스케이프하고 표현식을 따옴표로 묶습니다. 예를 들어
FILTER_EXPRESSION변수를"not(match(\"WFLY\")"로 교체하여not(match("WFLY"))의 필터 표현식을 만듭니다.
다음 명령을 사용하여 async 로그 처리기를 로거에 할당합니다.
/subsystem=logging/root-logger=ROOT:add-handler(name=ASYNC_HANDLER_NAME)로그 처리기를 활성화하려면 async 로그 처리기를 루트 로거 또는 기타 로거에 할당할 수 있습니다.
필요한 경우 다음 명령과 함께
remove작업을 사용하여 async 로그 처리기를 제거할 수 있습니다./subsystem=logging/async-handler=ASYNC_HANDLER_NAME:remove참고로깅 구성에 더 이상 필요하지 않은 경우 로그 처리기를 제거할 수 있습니다. 그러나 현재 로거에 할당된 경우 로그 처리기를 제거할 수 없습니다.