Liberty에서 추적 및 로깅 구성

Liberty 기능에 대해 Liberty의 추적 및 로깅 메커니즘을 사용할 수 있습니다. 로깅 서비스는 Liberty 커널의 일부이므로 이 서비스를 사용하기 위해 server.xml 파일에 기능을 지정하지 않아도 됩니다.

이 태스크 정보

Liberty는 사용자 정의된 기능 코드에서 추적 및 로깅을 통합할 수 있는 다음과 같은 SPI를 제공합니다.
com.ibm.websphere.ras
com.ibm.websphere.ras 패키지는 일부 확장점 외에도 메시지를 로그하고 레코드를 추적하는 클래스를 제공합니다. 일반적으로 기능 코드는 java.util.logging 패키지를 사용하여 추적과 메시지를 로깅하고 Liberty 로깅 구성을 통해 출력을 제어하지만 WebSphere® 패키지의 확장 기능이 유용한 경우가 있으며 추적을 사용하지 않을 때 추적 보호가 더 효율적입니다.
com.ibm.websphere.ras.annotations
com.ibm.websphere.ras.annotations 패키지는 다른 패키지의 클래스에서 사용할 어노테이션을 제공합니다. 예를 들어, @Sensitive 어노테이션을 사용하면 추적 또는 메시지 출력에서 어노테이션이 있는 변수의 컨텐츠가 표시되지 않게 합니다.
com.ibm.ws.ffdc
com.ibm.ws.ffdc 패키지는 예상치 못한 예외를 디버깅하는 데 도움이 되도록 FFDC(First Failure Data Capture) 레코드를 쓰는 기능을 제공합니다.
com.ibm.wsspi.logging
com.ibm.wsspi.logging 패키지는 로그 및 ffdc 레코드의 인터셉션 지점을 제공합니다.

각 Liberty SPI에 대한 Java™ API 문서는 ${wlp.install.dir}/dev 디렉토리의 javadoc 서브디렉토리 중 하나에 별도의 .zip 파일로 사용 가능합니다.

프로시저

다음 단계는 Liberty의 추적 및 로깅 메커니즘을 사용하기 위해 myfeature라고 하는 Liberty 기능 예제의 구성 방법을 표시합니다.

  1. myfeature 기능에 대한 메시지 파일의 위치와 com.ibm.websphere.ras.TraceComponent 클래스에 필요한 그룹의 이름을 지정하십시오.
    import java.util.ResourceBundle;
    
    public class myFeatureConstants {
    
        public static final String TR_RESOURCE_BUNDLE = 
            "com.mycompany.myFeature.internal.resources.FeatureMessages";
    
        public static final String TR_GROUP = "myFeature";
    
        public static final ResourceBundle messages = ResourceBundle.getBundle(TR_RESOURCE_BUNDLE);
    
    }
  2. 기능 서비스 코드의 구현 클래스에서 com.ibm.websphere.ras.TraceComponent 클래스의 register() 메소드를 호출하여 구현 클래스를 Liberty가 제공하는 추적 관리자에 등록하십시오. 그런 다음 기능의 DS 메소드를 추적하도록 추적 관리자를 구성할 수 있습니다.
    ...
    import com.ibm.websphere.ras.Tr;
    import com.ibm.websphere.ras.TraceComponent;
    
    
    public class myFeatureServiceImpl {
    
        private static final TraceComponent tc = Tr.register(myFeatureServiceImpl.class);
    
    
        protected void activate(ComponentContext cc, Map<String, Object> newProps) {
            if (tc.isDebugEnabled()) {
                Tr.debug(tc, "myFeatureComponentImpl activated"); }
    ...
  3. TraceOptions 어노테이션을 사용하여 추적 그룹 이름과 메시지 번들 이름을 지정하십시오.
    @TraceOptions(traceGroup = myFeatureConstants.TR_GROUP, messageBundle = 
        myFeatureConstants.TR_RESOURCE_BUNDLE)
    package com.mycompany.myFeature;
    
    import com.ibm.websphere.ras.annotation.TraceOptions;
    import com.mycompany.myfeature.internal.myFeatureConstants;
    ...

주제의 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_feat_logging
파일 이름: twlp_feat_logging.html