Red Hat Summit12.7. 로그 형식 구성
로그 포맷터는 해당 처리기의 로그 메시지 모양을 정의합니다. 이름이 지정된 패턴 포맷터 또는 사용자 정의 로그 포맷터를 구성할 수 있습니다.
12.7.1. 이름이 지정된 패턴 형식 구성
로그 처리기에서 로그 메시지를 포맷하는 데 사용할 수 있는 이름이 지정된 패턴 포맷터를 생성할 수 있습니다.
이 섹션에서는 관리 CLI를 사용하여 로그 포맷터를 구성하는 방법을 보여줍니다. 또한 Configuration 탭에서 Logging 하위 시스템으로 이동하여 Formatter 탭을 선택하고 왼쪽 메뉴에서 Pattern 을 선택하여 관리 콘솔을 사용하여 로그 포멧을 구성할 수도 있습니다.
로깅 프로필에 이 로그 포맷터를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
이름이 지정된 포맷 생성
포맷터를 정의할 때 로그 메시지를 포맷하는 데 사용할 패턴 문자열을 제공합니다. 패턴 구문에 대한 자세한 내용은 로그 형식 생성을 참조하십시오.
/subsystem=logging/pattern-formatter=PATTERN_FORMATTER_NAME:add(pattern=PATTERN_STRING)
/subsystem=logging/pattern-formatter=PATTERN_FORMATTER_NAME:add(pattern=PATTERN_STRING)
색상 맵을 정의하여 다른 로그 수준에 색상을 할당할 수도 있습니다. 형식은 쉼표로 구분된 LEVEL:COLOR 목록입니다.
-
유효한 수준: finer ,
finer, finer ,config,trace,debug,info,warning,warn,error,fatal,severe -
유효한 색상: ,
녹색,빨간색,노란색,파란색,cyan,흰색,광고색 ,굵은색녹색, Valblue , lightblue , lightblue, wideyellow, wideyelagenta , lightcyan , lightcyan.
/subsystem=logging/pattern-formatter=PATTERN_FORMATTER_NAME:write-attribute(name=color-map,value="LEVEL:COLOR,LEVEL:COLOR")
/subsystem=logging/pattern-formatter=PATTERN_FORMATTER_NAME:write-attribute(name=color-map,value="LEVEL:COLOR,LEVEL:COLOR")로그 처리기에 이름이 지정된 포터 할당
다음 관리 CLI 명령은 주기적 회전 파일 처리기에서 사용할 패턴 포맷터를 할당합니다.
/subsystem=logging/periodic-rotating-file-handler=FILE_HANDLER_NAME:write-attribute(name=named-formatter,value=PATTERN_FORMATTER_NAME)
/subsystem=logging/periodic-rotating-file-handler=FILE_HANDLER_NAME:write-attribute(name=named-formatter,value=PATTERN_FORMATTER_NAME)12.7.2. 사용자 정의 로그 포맷 구성
로그 처리기에서 로그 메시지를 포맷하는 데 사용할 수 있는 사용자 지정 로그 포맷터를 생성할 수 있습니다.
이 섹션에서는 관리 CLI를 사용하여 사용자 정의 로그 포맷터를 구성하는 방법을 보여줍니다. 또한 Configuration 탭에서 Logging 하위 시스템으로 이동하여 Formatter 탭을 선택한 다음 왼쪽 메뉴에서 Custom 을 선택하여 관리 콘솔을 사용하여 로그 포멧을 구성할 수도 있습니다.
사용자 정의 로그 포맷 구성
로깅 프로필에 이 로그 포맷터를 구성하는 경우 명령 시작은 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 대신 /subsystem=logging/ 입니다.
또한 관리형 도메인에서 실행 중인 경우 명령 앞에 /profile=PROFILE_NAME.
사용자 정의 로그 포맷터를 추가합니다.
사용자 지정 로그 포맷터를 추가할 때 포맷터의 Java 클래스와 포함된 JBoss EAP 모듈을 지정해야 합니다. 클래스는
java.util.logging.Formatter를 확장해야 합니다.참고사용자 지정 포맷터가 포함된 모듈을 이미 생성해야 합니다. 그렇지 않으면 이 명령이 실패합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /subsystem=logging/custom-formatter=CUSTOM_FORMATTER_NAME:add(class=CLASS_NAME, module=MODULE_NAME)
/subsystem=logging/custom-formatter=CUSTOM_FORMATTER_NAME:add(class=CLASS_NAME, module=MODULE_NAME)로그 포맷터에 필요한 속성을 설정합니다.
속성은 setter 방법을 사용하여 액세스할 수 있어야 합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /subsystem=logging/custom-formatter=CUSTOM_FORMATTER_NAME:write-attribute(name=properties.PROPERTY_NAME,value=PROPERTY_VALUE)
/subsystem=logging/custom-formatter=CUSTOM_FORMATTER_NAME:write-attribute(name=properties.PROPERTY_NAME,value=PROPERTY_VALUE)사용자 지정 포맷터를 로그 처리기에 할당합니다.
다음 관리 CLI 명령은 주기적 회전 파일 처리기에서 사용할 사용자 지정 포맷터를 할당합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /subsystem=logging/periodic-rotating-file-handler=FILE_HANDLER_NAME:write-attribute(name=named-formatter, value=CUSTOM_FORMATTER_NAME)
/subsystem=logging/periodic-rotating-file-handler=FILE_HANDLER_NAME:write-attribute(name=named-formatter, value=CUSTOM_FORMATTER_NAME)
사용자 정의 XML 포맷의 예
다음 예제에서는 사용자 지정 XML 포맷터를 구성합니다. org.jboss 클래스를 사용하여 콘솔 로그 처리기에 할당합니다.
.logmanager 모듈에 제공된 java.util.logging.19Formatter
/subsystem=logging/custom-formatter=custom-xml-formatter:add(class=java.util.logging.XMLFormatter, module=org.jboss.logmanager) /subsystem=logging/console-handler=CONSOLE:write-attribute(name=named-formatter, value=custom-xml-formatter)
/subsystem=logging/custom-formatter=custom-xml-formatter:add(class=java.util.logging.XMLFormatter, module=org.jboss.logmanager)
/subsystem=logging/console-handler=CONSOLE:write-attribute(name=named-formatter, value=custom-xml-formatter)이 포맷터를 사용하는 로그 메시지는 다음과 같이 포맷됩니다.
<record> <date>2016-03-23T12:58:13</date> <millis>1458752293091</millis> <sequence>93963</sequence> <logger>org.jboss.as</logger> <level>INFO</level> <class>org.jboss.as.server.BootstrapListener</class> <method>logAdminConsole</method> <thread>22</thread> <message>WFLYSRV0051: Admin console listening on http://%s:%d</message> <param>127.0.0.1</param> <param>9990</param> </record>
<record>
<date>2016-03-23T12:58:13</date>
<millis>1458752293091</millis>
<sequence>93963</sequence>
<logger>org.jboss.as</logger>
<level>INFO</level>
<class>org.jboss.as.server.BootstrapListener</class>
<method>logAdminConsole</method>
<thread>22</thread>
<message>WFLYSRV0051: Admin console listening on http://%s:%d</message>
<param>127.0.0.1</param>
<param>9990</param>
</record>
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}