Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

12.5. 로그 처리기 구성

로그 처리기는 캡처된 로그 메시지가 기록되는 방식을 정의합니다. 필요한 로그 처리기 유형을 구성하려면 적절한 섹션을 참조하십시오.

12.5.1. 콘솔 로그 처리기 구성

이 섹션에서는 관리 CLI를 사용하여 콘솔 로그 처리기를 구성하는 방법을 보여줍니다. 구성 탭에서 로깅 하위 시스템으로 이동하여 Handler 탭을 선택하고 왼쪽 메뉴에서 Console 을 선택하여 관리 콘솔을 사용하여 콘솔 로그 처리기를 구성할 수도 있습니다.

콘솔 로그 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

콘솔 로그 처리기 추가
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:add
Copy to clipboard
콘솔 로그 처리기 설정 구성

필요에 따라 다음 콘솔 로그 처리기 특성 중 하나 이상을 설정해야 할 수 있습니다. 사용 가능한 콘솔 로그 처리기 속성 및 해당 설명의 전체 목록은 콘솔 로그 처리기 특성을 참조하십시오.

  • 로그 수준을 설정합니다.

    처리기에 적절한 로그 수준을 설정합니다. 기본값은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 대상을 설정합니다.

    System.out,System.err 또는 콘솔 중 하나일 수 있는 처리기의 대상을 설정합니다. 기본값은 System.out 입니다. 

    /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=target,value=TARGET)
    Copy to clipboard

  • 인코딩을 설정합니다.

    처리기의 인코딩을 설정합니다(예: utf-8 ). 

    /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)
    Copy to clipboard

  • 로그 포맷터를 설정합니다.

    처리기의 포맷터 문자열을 설정합니다. 예를 들어 기본 형식 문자열은 %d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n 입니다. FORMAT 값을 따옴표로 묶어야 합니다. 

    /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)
    Copy to clipboard
    참고

  • 자동 플러시를 설정합니다.

    각 쓰기 후 자동으로 플러시할지 여부를 설정합니다. 기본값은 true입니다. 

    /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)
    Copy to clipboard

  • 필터 표현식을 설정합니다.

    처리기의 로그 메시지를 필터링하기 위한 표현식을 설정합니다. 쉼표와 따옴표로 이스케이프하고 따옴표로 묶어야 합니다. 예를 들어 아래 FILTER_EXPRESSION 대체 가능한 변수는 not(match("WFLY")의 필터 표현식에 대해 " not(match(\ "WFLY\")" 로 교체해야 합니다. 

    /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
    Copy to clipboard

    사용 가능한 필터 식에 대한 자세한 내용은 식 필터링 섹션을 참조하십시오.

Log Handler를 Log Handler에 할당

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 콘솔 로그 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=CONSOLE_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 CATEGORY 에서 지정하는 이름을 가진 로거에 콘솔 로그 처리기를 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=CONSOLE_HANDLER_NAME)
Copy to clipboard
콘솔 로그 처리기 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:remove
Copy to clipboard

12.5.2. 파일 로그 처리기 구성

이 섹션에서는 관리 CLI를 사용하여 파일 로그 처리기를 구성하는 방법을 보여줍니다. 구성 탭에서 로깅 하위 시스템으로 이동하여 Handler 탭을 선택하고 왼쪽 메뉴에서 File 을 선택하여 관리 콘솔을 사용하여 파일 로그 처리기를 구성할 수도 있습니다.

파일 로그 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

파일 로그 처리기 추가

파일 로그 처리기를 추가할 때 경로 및 relative-to 속성으로 구성된 file 속성을 사용하여 파일 경로를 지정해야 합니다. 경로 속성을 사용하여 이름을 포함하여 로그의 파일 경로를 설정합니다(예: my-log.log ). 선택적으로 relative-to 특성을 사용하여 경로가 이름이 지정된 경로 (예: jboss.server.log.dir )에 상대적으로 설정되도록 설정합니다. 

/subsystem=logging/file-handler=FILE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})
Copy to clipboard
파일 로그 처리기 설정 구성

필요에 따라 다음 파일 로그 처리기 특성 중 하나 이상을 설정해야 할 수 있습니다. 사용 가능한 파일 로그 처리기 속성 및 해당 설명의 전체 목록은 파일 로그 처리기 특성을 참조하십시오.

  • 로그 수준을 설정합니다.

    처리기에 적절한 로그 수준을 설정합니다. 기본값은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 추가 동작을 설정합니다.

    기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다. 서버를 다시 시작할 때 파일을 덮어쓰도록 하려면 append 속성을 false 로 설정할 수 있습니다. 

    /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=append,value=APPEND)
    Copy to clipboard

  • 인코딩을 설정합니다.

    처리기의 인코딩을 설정합니다(예: utf-8 ). 

    /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)
    Copy to clipboard

  • 로그 포맷터를 설정합니다.

    처리기의 포맷터 문자열을 설정합니다. 예를 들어 기본 형식 문자열은 %d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n 입니다. FORMAT 값을 따옴표로 묶어야 합니다. 

    /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)
    Copy to clipboard
    참고

  • 자동 플러시를 설정합니다.

    각 쓰기 후 자동으로 플러시할지 여부를 설정합니다. 기본값은 true입니다. 

    /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)
    Copy to clipboard

  • 필터 표현식을 설정합니다.

    처리기의 로그 메시지를 필터링하기 위한 표현식을 설정합니다. 쉼표와 따옴표로 이스케이프하고 따옴표로 묶어야 합니다. 예를 들어 아래 FILTER_EXPRESSION 대체 가능한 변수는 not(match("WFLY")의 필터 표현식에 대해 " not(match(\ "WFLY\")" 로 교체해야 합니다. 

    /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
    Copy to clipboard

    사용 가능한 필터 식에 대한 자세한 내용은 식 필터링 섹션을 참조하십시오.

Logger에 파일 로그 처리기 할당

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 파일 로그 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=FILE_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 CATEGORY 에서 지정하는 이름을 가진 로거에 파일 로그 처리기를 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=FILE_HANDLER_NAME)
Copy to clipboard
파일 로그 처리기 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/file-handler=FILE_HANDLER_NAME:remove
Copy to clipboard

12.5.3. Periodic Rotating Log Handler 구성

이 섹션에서는 관리 CLI를 사용하여 주기적인 회전 로그 처리기를 구성하는 방법을 보여줍니다. 구성 탭에서 로깅 하위 시스템으로 이동하여 Handler 탭을 선택하고 왼쪽 메뉴에서 Periodic 을 선택하여 관리 콘솔을 사용하여 주기적인 로그 처리기를 구성할 수도 있습니다.

주기적인 로그 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

Periodic Log Handler 추가

주기적인 로그 처리기를 추가할 때 경로 및 relative-to 속성으로 구성된 file 속성을 사용하여 파일 경로를 지정해야 합니다. 경로 속성을 사용하여 이름을 포함하여 로그의 파일 경로를 설정합니다(예: my-log.log ). 선택적으로 relative-to 특성을 사용하여 경로가 이름이 지정된 경로 (예: jboss.server.log.dir )에 상대적으로 설정되도록 설정합니다.

접미사 특성을 사용하여 순환된 로그의 접미사 도 설정해야 합니다. 이는 java.text.SimpleDateFormat 에서 이해할 수 있는 형식이어야 합니다(예: .yyyy-MM-dd-HH ). 순환 기간은 이 접미사에 따라 자동으로 계산됩니다. 

/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)
Copy to clipboard
Periodic Log Handler 설정 구성

필요에 따라 다음 주기 로그 처리기 특성 중 하나 이상을 설정해야 할 수 있습니다. 사용 가능한 주기적인 로그 처리기 속성 및 해당 설명의 전체 목록은 Periodic Log Handler 특성을 참조하십시오.

  • 로그 수준을 설정합니다.

    처리기에 적절한 로그 수준을 설정합니다. 기본값은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 추가 동작을 설정합니다.

    기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다. 서버를 다시 시작할 때 파일을 덮어쓰도록 하려면 append 속성을 false 로 설정할 수 있습니다. 

    /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=append,value=APPEND)
    Copy to clipboard

  • 인코딩을 설정합니다.

    처리기의 인코딩을 설정합니다(예: utf-8 ). 

    /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)
    Copy to clipboard

  • 로그 포맷터를 설정합니다.

    처리기의 포맷터 문자열을 설정합니다. 예를 들어 기본 형식 문자열은 %d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n 입니다. FORMAT 값을 따옴표로 묶어야 합니다. 

    /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)
    Copy to clipboard
    참고

  • 자동 플러시를 설정합니다.

    각 쓰기 후 자동으로 플러시할지 여부를 설정합니다. 기본값은 true입니다. 

    /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)
    Copy to clipboard

  • 필터 표현식을 설정합니다.

    처리기의 로그 메시지를 필터링하기 위한 표현식을 설정합니다. 쉼표와 따옴표로 이스케이프하고 따옴표로 묶어야 합니다. 예를 들어 아래 FILTER_EXPRESSION 대체 가능한 변수는 not(match("WFLY")의 필터 표현식에 대해 " not(match(\ "WFLY\")" 로 교체해야 합니다. 

    /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
    Copy to clipboard

    사용 가능한 필터 식에 대한 자세한 내용은 식 필터링 섹션을 참조하십시오.

Log Handler를 Logger에 할당합니다.

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 주기적인 로그 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 CATEGORY 에서 지정하는 이름을 가진 로거에 주기 로그 처리기를 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=PERIODIC_HANDLER_NAME)
Copy to clipboard
Periodic Log Handler 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:remove
Copy to clipboard

12.5.4. 크기 회전 로그 처리기 구성

이 섹션에서는 관리 CLI를 사용하여 크기 회전 로그 처리기를 구성하는 방법을 보여줍니다. 구성 탭에서 로깅 하위 시스템으로 이동하여 Handler 탭을 선택하고 왼쪽 메뉴에서 Size를 선택하여 관리 콘솔을 사용하여 크기 로그 처리기를 구성할 수도 있습니다.

크기 로그 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

크기 로그 처리기 추가

크기 로그 처리기를 추가할 때 경로 및 relative-to 속성으로 구성된 file 속성을 사용하여 파일 경로를 지정해야 합니다. 경로 속성을 사용하여 이름을 포함하여 로그의 파일 경로를 설정합니다(예: my-log.log ). 선택적으로 relative-to 특성을 사용하여 경로가 이름이 지정된 경로 (예: jboss.server.log.dir )에 상대적으로 설정되도록 설정합니다. 

/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})
Copy to clipboard
크기 로그 처리기 설정 구성

필요에 따라 다음 크기 로그 처리기 특성 중 하나 이상을 설정해야 할 수 있습니다. 사용 가능한 크기 로그 처리기 속성 및 해당 설명의 전체 목록은 크기 로그 처리기 특성을 참조하십시오.

  • 로그 수준을 설정합니다.

    처리기에 적절한 로그 수준을 설정합니다. 기본값은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 순환된 로그의 접미사를 설정합니다.

    java.text.SimpleDateFormat 에서 이해할 수 있는 형식의 접미사 문자열(예: .yyyy-MM-dd-HH )을 설정합니다. 순환 기간은 이 접미사에 따라 자동으로 계산됩니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=suffix, value=SUFFIX)
    Copy to clipboard

  • 회전 크기를 설정합니다.

    순환하기 전에 파일이 도달할 수 있는 최대 크기를 설정합니다. 기본값은 2MB의 경우 2m 입니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)
    Copy to clipboard

  • 유지할 최대 백업 로그 수를 설정합니다.

    유지할 백업 수를 설정합니다. 기본값은 1입니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)
    Copy to clipboard

  • 부팅 시 로그를 회전할지 여부를 설정합니다.

    기본적으로 서버를 다시 시작할 때 새 로그 파일이 생성되지 않습니다. 이 값을 true 로 설정하여 서버 다시 시작 시 로그를 순환할 수 있습니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)
    Copy to clipboard

  • 추가 동작을 설정합니다.

    기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다. 서버를 다시 시작할 때 파일을 덮어쓰도록 하려면 append 속성을 false 로 설정할 수 있습니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)
    Copy to clipboard

  • 인코딩을 설정합니다.

    처리기의 인코딩을 설정합니다(예: utf-8 ). 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)
    Copy to clipboard

  • 로그 포맷터를 설정합니다.

    처리기의 포맷터 문자열을 설정합니다. 예를 들어 기본 형식 문자열은 %d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n 입니다. FORMAT 값을 따옴표로 묶어야 합니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)
    Copy to clipboard
    참고

  • 자동 플러시를 설정합니다.

    각 쓰기 후 자동으로 플러시할지 여부를 설정합니다. 기본값은 true입니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)
    Copy to clipboard

  • 필터 표현식을 설정합니다.

    처리기의 로그 메시지를 필터링하기 위한 표현식을 설정합니다. 쉼표와 따옴표로 이스케이프하고 따옴표로 묶어야 합니다. 예를 들어 아래 FILTER_EXPRESSION 대체 가능한 변수는 not(match("WFLY")의 필터 표현식에 대해 " not(match(\ "WFLY\")" 로 교체해야 합니다. 

    /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
    Copy to clipboard

    사용 가능한 필터 식에 대한 자세한 내용은 식 필터링 섹션을 참조하십시오.

Log Handler 를 Logger에 할당

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 크기 로그 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=SIZE_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 CATEGORY 에서 지정하는 이름을 가진 로거에 크기 로그 처리기를 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=SIZE_HANDLER_NAME)
Copy to clipboard
크기 로그 처리기 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:remove
Copy to clipboard

12.5.5. 기간 크기 회전 로그 처리기 구성

이 섹션에서는 관리 CLI를 사용하여 주기적인 크기 회전 로그 처리기를 구성하는 방법을 보여줍니다. 또한 로깅 하위 시스템으로 이동하여 Handler 탭을 선택하고 왼쪽 메뉴에서 Periodic Size 를 선택하여 관리 콘솔을 사용하여 주기적인 크기 로그 처리기를 구성할 수도 있습니다.

주기적인 크기 로그 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

주기적인 크기 로그 처리기 추가

주기적인 크기 로그 처리기를 추가할 때 경로 및 relative-to 속성으로 구성된 file 속성을 사용하여 파일 경로를 지정해야 합니다. 경로 속성을 사용하여 이름을 포함하여 로그의 파일 경로를 설정합니다(예: my-log.log ). 선택적으로 relative-to 특성을 사용하여 경로가 이름이 지정된 경로 (예: jboss.server.log.dir )에 상대적으로 설정되도록 설정합니다.

접미사 특성을 사용하여 순환된 로그의 접미사 도 설정해야 합니다. 이는 java.text.SimpleDateFormat 에서 이해할 수 있는 형식이어야 합니다(예: .yyyy-MM-dd-HH ). 순환 기간은 이 접미사에 따라 자동으로 계산됩니다. 

/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)
Copy to clipboard
Periodic Size Log Handler 설정 구성

필요에 따라 다음 주기 크기 로그 처리기 특성 중 하나 이상을 설정해야 할 수 있습니다.Depending on your needs, you may need to set one or more of the following periodic size log handler attributes. 사용 가능한 주기적인 크기 로그 처리기 속성 및 해당 설명의 전체 목록은 주기적인 크기 로그 처리기 특성을 참조하십시오.

  • 로그 수준을 설정합니다.

    처리기에 적절한 로그 수준을 설정합니다. 기본값은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 회전 크기를 설정합니다.

    순환하기 전에 파일이 도달할 수 있는 최대 크기를 설정합니다. 기본값은 2MB의 경우 2m 입니다. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)
    Copy to clipboard

  • 유지할 최대 백업 로그 수를 설정합니다.

    유지할 백업 수를 설정합니다. 기본값은 1입니다. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)
    Copy to clipboard

  • 부팅 시 로그를 회전할지 여부를 설정합니다.

    기본적으로 서버를 다시 시작할 때 새 로그 파일이 생성되지 않습니다. 이 값을 true 로 설정하여 서버 다시 시작 시 로그를 순환할 수 있습니다. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)
    Copy to clipboard

  • 추가 동작을 설정합니다.

    기본적으로 JBoss EAP는 서버를 다시 시작할 때 동일한 파일에 로그 메시지를 추가합니다. 서버를 다시 시작할 때 파일을 덮어쓰도록 하려면 append 속성을 false 로 설정할 수 있습니다. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)
    Copy to clipboard

  • 인코딩을 설정합니다.

    처리기의 인코딩을 설정합니다(예: utf-8 ). 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)
    Copy to clipboard

  • 로그 포맷터를 설정합니다.

    처리기의 포맷터 문자열을 설정합니다. 예를 들어 기본 형식 문자열은 %d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n 입니다. FORMAT 값을 따옴표로 묶어야 합니다. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)
    Copy to clipboard
    참고

  • 자동 플러시를 설정합니다.

    각 쓰기 후 자동으로 플러시할지 여부를 설정합니다. 기본값은 true입니다. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)
    Copy to clipboard

  • 필터 표현식을 설정합니다.

    처리기의 로그 메시지를 필터링하기 위한 표현식을 설정합니다. 쉼표와 따옴표로 이스케이프하고 따옴표로 묶어야 합니다. 예를 들어 아래 FILTER_EXPRESSION 대체 가능한 변수는 not(match("WFLY")의 필터 표현식에 대해 " not(match(\ "WFLY\")" 로 교체해야 합니다. 

    /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
    Copy to clipboard

    사용 가능한 필터 식에 대한 자세한 내용은 식 필터링 섹션을 참조하십시오.

Log Handler를 Log Handler에 할당합니다.

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 주기적인 크기 로그 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 주기적인 크기 로그 처리기를 CATEGORY 에서 지정하는 이름의 로거에 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)
Copy to clipboard
주기적인 크기 로그 처리기 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:remove
Copy to clipboard

12.5.6. Syslog 처리기 구성

이 섹션에서는 Syslog 프로토콜(RFC-3164 또는 RFC-5424)을 지원하는 원격 로깅 서버로 메시지를 보내는 데 사용할 수 있는 관리 CLI를 사용하여 syslog 처리기를 구성하는 방법을 보여줍니다. 구성 탭에서 로깅 하위 시스템으로 이동하여 Handler 탭을 선택하고 왼쪽 메뉴에서 Syslog 를 선택하여 관리 콘솔을 사용하여 syslog 처리기를 구성할 수도 있습니다.

syslog 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

Syslog 처리기 추가
/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:add
Copy to clipboard
Syslog Handler 설정 구성

필요에 따라 다음 syslog 처리기 속성 중 하나 이상을 설정해야 할 수 있습니다. 사용 가능한 syslog 처리기 속성 및 해당 설명의 전체 목록은 Syslog Handler 특성을 참조하십시오.

  • 처리기의 로그 수준을 설정합니다. 기본 수준은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 로깅되는 애플리케이션의 이름을 설정합니다. 기본 이름은 java 입니다. 

    /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=app-name,value=APP_NAME)
    Copy to clipboard

  • syslog 서버의 주소를 설정합니다. 기본 주소는 localhost 입니다. 

    /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=server-address,value=SERVER_ADDRESS)
    Copy to clipboard

  • syslog 서버의 포트를 설정합니다. 기본 포트는 514 입니다. 

    /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=port,value=PORT)
    Copy to clipboard

  • RFC 사양에 정의된 syslog 형식을 설정합니다. 기본 형식은 RFC5424 입니다. 

    /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=syslog-format,value=SYSLOG_FORMAT)
    Copy to clipboard
Logger에 Syslog 처리기 할당

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 syslog 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=SYSLOG_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 CATEGORY 에서 지정하는 이름을 가진 로거에 syslog 처리기를 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=SYSLOG_HANDLER_NAME)
Copy to clipboard
Syslog 처리기 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:remove
Copy to clipboard

12.5.7. 사용자 정의 로그 처리기 구성

이 섹션에서는 관리 CLI를 사용하여 사용자 정의 로그 처리기를 구성하는 방법을 보여줍니다. 구성 탭에서 로깅 하위 시스템으로 이동하여 Handler 탭을 선택하고 왼쪽 메뉴에서 Custom Custom을 선택하여 관리 콘솔을 사용하여 사용자 지정 로그 처리기를 구성할 수도 있습니다.

사용자 정의 로그 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

사용자 정의 로그 처리기 추가

사용자 지정 로그 처리기를 추가할 때 처리기의 Java 클래스와 포함된 JBoss EAP 모듈을 지정해야 합니다. 클래스는 java.util.logging.Handler 를 확장해야 합니다.

참고

사용자 지정 로거 가 포함된 모듈을 이미 생성해야 합니다. 그렇지 않으면 이 명령이 실패합니다. 

/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:add(class=CLASS_NAME,module=MODULE_NAME)
Copy to clipboard
사용자 정의 로그 처리기 설정 구성

필요에 따라 다음 사용자 지정 로그 처리기 특성 중 하나 이상을 설정해야 할 수 있습니다. 사용 가능한 사용자 정의 로그 처리기 속성 및 해당 설명의 전체 목록은 사용자 정의 로그 처리기 특성을 참조하십시오.

  • 로그 수준을 설정합니다.

    처리기에 적절한 로그 수준을 설정합니다. 기본값은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 속성을 설정합니다.

    로그 처리기에 필요한 속성을 설정합니다. 속성은 setter 방법을 사용하여 액세스할 수 있어야 합니다. 

    /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=properties.PROPERTY_NAME,value=PROPERTY_VALUE)
    Copy to clipboard

  • 인코딩을 설정합니다.

    처리기의 인코딩을 설정합니다(예: utf-8 ). 

    /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)
    Copy to clipboard

  • 로그 포맷터를 설정합니다.

    처리기의 포맷터 문자열을 설정합니다. 예를 들어 기본 형식 문자열은 %d{HH:mm:ss,SSS} %-5p [%t] (%t) %s%e%n 입니다. FORMAT 값을 따옴표로 묶어야 합니다. 

    /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)
    Copy to clipboard
    참고

  • 필터 표현식을 설정합니다.

    처리기의 로그 메시지를 필터링하기 위한 표현식을 설정합니다. 쉼표와 따옴표로 이스케이프하고 따옴표로 묶어야 합니다. 예를 들어 아래 FILTER_EXPRESSION 대체 가능한 변수는 not(match("WFLY")의 필터 표현식에 대해 " not(match(\ "WFLY\")" 로 교체해야 합니다. 

    /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
    Copy to clipboard

    사용 가능한 필터 식에 대한 자세한 내용은 식 필터링 섹션을 참조하십시오.

Log Handler를 Logger에 할당

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 사용자 정의 로그 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=CUSTOM_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 CATEGORY 에서 지정하는 이름을 가진 로거에 사용자 정의 로그 처리기를 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=CUSTOM_HANDLER_NAME)
Copy to clipboard
사용자 정의 로그 처리기 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거 또는 async 로그 처리기에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:remove
Copy to clipboard

12.5.8. Async 로그 처리기 구성

이 섹션에서는 관리 CLI를 사용하여 비동기 로그 처리기를 구성하는 방법을 보여줍니다. 구성 탭에서 로깅 하위 시스템으로 이동하고, Handler 탭을 선택하고, 왼쪽 메뉴에서 Async 를 선택하여 관리 콘솔을 사용하여 비동기 로그 처리기를 구성할 수도 있습니다.

async 로그 처리기를 구성하기 위해 수행할 주요 작업은 다음과 같습니다.

중요

로깅 프로필에 대해 이 로그 처리기를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.

또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.

Async 로그 처리기 추가

async 로그 처리기를 추가할 때 큐 길이를 지정해야 합니다. 큐에서 보유할 수 있는 최대 로그 요청 수입니다. 

/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add(queue-length=QUEUE_LENGTH)
Copy to clipboard
하위 핸들러 추가

이 비동기 로그 처리기의 하위 핸들러로 하나 이상의 처리기를 추가할 수 있습니다. 처리기가 구성에 이미 있어야 합니다. 그렇지 않으면 이 명령이 실패합니다. 

/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add-handler(name=HANDLER_NAME)
Copy to clipboard
Async 로그 처리기 설정 구성

필요에 따라 다음 async 로그 처리기 특성 중 하나 이상을 설정해야 할 수 있습니다. 사용 가능한 비동기 로그 처리기 속성 및 해당 설명의 전체 목록은 Async 로그 처리기 특성을 참조하십시오.

  • 로그 수준을 설정합니다.

    처리기에 적절한 로그 수준을 설정합니다. 기본값은 ALL 입니다. 사용 가능한 모든 옵션은 로그 수준을 참조하십시오. 

    /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=level,value=LEVEL)
    Copy to clipboard

  • 오버플로 작업을 설정합니다.

    오버플로할 때 수행할 작업을 설정합니다. 기본값은 BLOCK 입니다. 즉, 전체 큐가 발생할 경우 스레드가 차단됩니다. 이 값을 DISCARD 로 변경할 수 있습니다. 즉, 전체 대기열의 경우 로그 메시지가 삭제됩니다. 

    /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=overflow-action,value=OVERFLOW_ACTION)
    Copy to clipboard

  • 필터 표현식을 설정합니다.

    처리기의 로그 메시지를 필터링하기 위한 표현식을 설정합니다. 쉼표와 따옴표로 이스케이프하고 따옴표로 묶어야 합니다. 예를 들어 아래 FILTER_EXPRESSION 대체 가능한 변수는 not(match("WFLY")의 필터 표현식에 대해 " not(match(\ "WFLY\")" 로 교체해야 합니다. 

    /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
    Copy to clipboard

    사용 가능한 필터 식에 대한 자세한 내용은 식 필터링 섹션을 참조하십시오.

Async 로그 처리기를 Logger에 할당

로그 처리기를 활성화하려면 로거에 할당해야 합니다.

다음 관리 CLI 명령은 async 로그 처리기를 루트 로거에 할당합니다. 

/subsystem=logging/root-logger=ROOT:add-handler(name=ASYNC_HANDLER_NAME)
Copy to clipboard

다음 관리 CLI 명령은 CATEGORY 에서 지정하는 이름이 있는 로거에 async 로그 처리기를 할당합니다. 

/subsystem=logging/logger=CATEGORY:add-handler(name=ASYNC_HANDLER_NAME)
Copy to clipboard
Async 로그 처리기 제거

제거 작업을 사용하여 로그 처리기를 제거할 수 있습니다. 현재 로거에 할당된 경우 로그 처리기를 제거할 수 없습니다. 

/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:remove
Copy to clipboard
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat, Inc.