Liberty의 SIP(Session Initiation Protocol) 2진 로그 및 추적 확장기능

2진 로깅은 개발자에게 로그 및 추적 레코드에 확장 필드를 추가하는 방법을 제공하며, 사용자에게 확장 값으로 로그 및 추적 레코드를 필터링하는 대응되는 방법을 제공합니다.

로그 및 추적 레코드에는 레코드 작성 시간 및 로깅된 메시지의 컨텐츠 등과 같은 정보의 필드가 포함됩니다. 이 필드는 모든 로그 및 추적 레코드에 존재하는 핵심 필드입니다. 이와는 대조적으로 확장 필드는 애플리케이션 개발자가 로그 및 추적 레코드에 추가할 수 있는 필드이며, 이를 특정 로그 및 추적 컨텐츠를 검색할 때 필터 기준으로 사용할 수 있습니다. 이 로그 및 추적 확장기능은 고급 형식을 사용하도록 텍스트 출력 형식을 구성할 때 2진 로그에서 표시되거나, 고급 형식으로 binaryLog 명령을 사용할 때 표시됩니다.

관리자

애플리케이션 서버는 로그 및 추적 레코드를 필터링하는 데 사용할 수 있는 다수의 확장기능을 자동으로 작성합니다. 또한 사용자는 애플리케이션 개발자가 추가한 확장기능을 사용하여 로그 및 추적 레코드를 필터링할 수도 있습니다. binaryLog 명령행 도구를 사용하면 로그 및 추적 레코드 확장기능의 컨텐츠를 기반으로 레코드를 필터링할 수 있습니다. 추가 정보는 BinaryLog 명령 옵션의 내용을 참조하십시오.

예를 들어, SIP 컨테이너가 처리한 모든 SIP 애플리케이션 세션을 보기 위해 다음과 같은 binaryLog 명령을 사용할 수 있습니다.
binaryLog view binaryFile --includeExtension=SIPASId=* --format=advanced
개발자

개발자는 2진 로깅을 사용함으로써 로그 레코드 컨텍스트 API, com.ibm.websphere.logging.hpel.LogRecordContext를 통해 로그 및 추적 레코드에 사용자 정의 확장기능을 추가할 수 있습니다. 2진 로깅이 로그 및 추적 레코드를 저장하는 경우, 여기에는 동일한 스레드의 로그 레코드 컨텍스트에 존재하는 확장기능이 포함됩니다. 예를 들어, 서블릿 필터를 작성하여 로그 레코드 컨텍스트에 중요한 HTTP 요청 매개변수를 추가할 수 있습니다. 서블릿이 실행되는 동안, HPEL API는 동일한 스레드에서 작성된 로그 및 추적 레코드에 해당 확장기능을 추가합니다.

기타 로그 및 추적 레코드 필드에서와 마찬가지로, 개발자는 HPEL API를 사용하여 레코드 확장기능에 액세스할 수 있습니다. 이는 로그 및 추적 저장소에서 읽을 수 있도록 도구를 작성할 때 유용합니다. 또한 개발자는 로그 레코드 컨텍스트 API를 사용하여 런타임에 사용자 정의 로그 핸들러, 필터 및 포맷터의 확장기능에 액세스할 수 있습니다.

다음 표에서는 다양한 측면의 추적을 필터링하는 데 사용할 수 있는 ID를 포함하여 로그 및 추적 확장기능을 설명합니다.

표 1. 로그 및 추적 확장기능
확장기능 설명
appName

로그 또는 추적 레코드와 관련된 Java™ EE(Java Platform, Enterprise Edition) 애플리케이션의 이름을 지정합니다(있는 경우).

requestID

각 로그 또는 추적 레코드가 관련된 요청의 고유 ID를 지정합니다(있는 경우). 애플리케이션 서버가 로그 및 추적 레코드에 requestID 확장기능을 추가할 수 있으려면, 관리 콘솔에서 로그 및 추적 상관이라고도 하는 XCT(Cross Component Trace)를 사용으로 설정해야 합니다. 요청 ID는 오직 특정 유형의 요청에 대해서만 추가됩니다(예: HTTP 또는 JMS 요청).

SIPCallId

SIP 프록시 서버 또는 SIP 컨테이너에 의해 처리되는 SIP 호출 ID를 지정합니다. 이 정보는 SIP 프록시 서버 및 SIP 컨테이너에서 공통입니다. 이 확장기능을 사용하여 다양한 컴포넌트에서 SIP 호출 플로우를 추적할 수 있습니다. SIP 프록시 서버 및 SIP 컨테이너는 HPEL 로깅이 사용될 때 이 ID를 각 로그 및 추적 레코드에 자동으로 추가합니다.

SIPASId

SIP 컨테이너가 처리 중인 SIP 애플리케이션 세션 ID를 지정합니다. 이 정보는 SIP 컨테이너에서 공통입니다. 이 확장기능을 사용하여 SIP 호출 플로우를 추적할 수 있습니다. SIP 컨테이너는 HPEL 로깅이 사용될 때 이 ID를 각 로그 및 추적 레코드에 자동으로 추가합니다.

 SIPSessionId

SIP 컨테이너가 처리 중인 SIP 세션 ID를 지정합니다. 이 정보는 SIP 컨테이너에서 공통입니다. 이 확장기능을 사용하여 SIP 호출 플로우를 추적할 수 있습니다. SIP 컨테이너는 HPEL 로깅이 사용될 때 이 ID를 각 로그 및 추적 레코드에 자동으로 추가합니다.

SIPCallId2

동일한 SIP 애플리케이션 세션과 연관되어 있으며 SIP 컨테이너에 의해 처리되는 두 번째 SIP 호출 ID를 지정합니다. 이 정보는 SIP 컨테이너에서 공통입니다. 이 확장기능을 사용하여 SIP 호출 플로우를 추적할 수 있습니다. SIP 컨테이너는 HPEL 로깅이 사용될 때 이 ID를 각 로그 및 추적 레코드에 자동으로 추가합니다.

둘 이상의 SIP 호출 ID가 단일 SIP 애플리케이션 세션과 연관된 경우에는 오직 처음 두 개의 ID만 기록됩니다. 추가 ID는 기록되지 않습니다.

SIPSessionId2

동일한 SIP 애플리케이션 세션과 연관되어 있으며 SIP 컨테이너에 의해 처리되는 두 번째 SIP 세션 ID를 지정합니다. 이 정보는 SIP 컨테이너에서 공통입니다. 이 확장기능을 사용하여 SIP 호출 플로우를 추적할 수 있습니다. SIP 컨테이너는 HPEL 로깅이 사용될 때 이 ID를 각 로그 및 추적 레코드에 자동으로 추가합니다.

둘 이상의 SIP 세션 ID가 단일 SIP 애플리케이션 세션과 연관된 경우에는 오직 처음 두 개의 ID만 기록됩니다. 추가 ID는 기록되지 않습니다.

thread

각 로그 또는 추적 레코드가 관련된 요청의 스레드 이름을 지정합니다.


주제의 유형을 표시하는 아이콘 참조 주제

파일 이름: rwlp_sip_logtraceextensions.html