사용자 정의 C 확장에서 추적 로그 기록 사용

C 프로그래밍 언어 API에 기록된 메시지 처리 노드와 구문 분석기는 추적할 항목을 기록할 수 있습니다.

추적에는 두 가지 유형이 있습니다.
  • 서비스 추적: 입력 항목은 보통 코드 내에서 발생한 사항을 설명하며 사용자 정의 확장 개발자와 같은 코드 소유자에게만 유용합니다.
  • 사용자 추적: 입력 항목은 보통 외부 레벨에서 발생한 사항을 설명하며 코드 사용자에게 유용합니다. 코드 사용자로는 메시지 플로우 설계자, 브로커 도메인 관리자가 있습니다.
각 추적 유형에는 다음과 같은 세 가지 레벨이 있습니다.
  • 없음
  • 정상
  • 디버그
C 사용자 정의 확장의 경우, 각 추적 유형에 다음과 같은 유틸리티 함수를 사용할 수 있습니다.
  • cciServiceTracecciUserTrace: 이 함수는 추적이 활성화된 경우, 즉 추적이 정상 레벨이나 디버그 레벨일 때만 입력 항목을 각 추적 유형에 기록합니다.
  • cciServiceDebugTracecciUserDebugTrace: 이 함수는 추적이 디버그 레벨에서 활성인 경우에만 입력 항목을 각 추적 유형에 기록합니다.
추적이 기록되지 않는 경우 함수 호출을 막을 수 있도록 도와주는 cciIsTraceActive 유틸리티 함수가 제공됩니다. cciIsTraceActive는 추적이 활성인지 여부와 추적이 활성 상태인 레벨을 보고합니다.

cci*Trace 함수는 추적 설정과 관계없이 사용자 정의 확장에 사용할 수 있습니다. 함수는 추적이 활성인지 판별하고 추적 설정에 맞는 입력 항목만 기록합니다. cci*Trace 함수를 호출할 때 추가 처리가 필요할 수 있습니다. 사용자 정의 확장이 추적 설정을 조회하고 추적이 비활성일 때 추가 처리가 발생하지 않도록 해주는 cciIsTraceActive 함수가 제공됩니다.

대부분의 경우 cciIsTraceActive 함수에서 리턴한 값은 Boolean 값으로 처리하면 됩니다. 리턴 값이 0이 아니면 추적은 일부 레벨에서 활성이며 cci*Trace 함수를 호출하는 데 적절합니다. 추적 레벨의 세부사항이 필요한 경우에도 리턴 값을 자세히 검사할 수 있습니다.

추적 설정은 언제든지 변경할 수 있으므로 정기적으로 조회하는 것이 좋습니다. 예를 들어 cciIsTraceActive를 사용하여 구현 함수가 입력될 때 추적 설정을 조회하십시오.

추적 입력 항목은 추적 쓰기를 위해 자세히 제어할 수 있는 특정 오브젝트와 연관될 수 있습니다. 추적 입력 항목은 노드 또는 구문 분석기와 연관될 수 있으며 추적은 해당 오브젝트의 추적 설정에 따라 기록됩니다. 오브젝트의 추적 설정은 노드 또는 구문 분석기가 속한 메시지 플로우로부터 상속받습니다. 오브젝트가 지정되지 않은 경우 추적은 실행 그룹과 연관됩니다.

관련 참조
cciUserDebugTrace
cciServiceTrace
cciServiceDebugTrace
ccilsTraceActive
사용자 추적
서비스 추적
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as24550_