C 프로그래밍 언어 API에 기록된 메시지 처리 노드와 구문 분석기는 추적할 항목을 기록할 수 있습니다.
cci*Trace 함수는 추적 설정과 관계없이 사용자 정의 확장에 사용할 수 있습니다. 함수는 추적이 활성인지 판별하고 추적 설정에 맞는 입력 항목만 기록합니다. cci*Trace 함수를 호출할 때 추가 처리가 필요할 수 있습니다. 사용자 정의 확장이 추적 설정을 조회하고 추적이 비활성일 때 추가 처리가 발생하지 않도록 해주는 cciIsTraceActive 함수가 제공됩니다.
대부분의 경우 cciIsTraceActive 함수에서 리턴한 값은 Boolean 값으로 처리하면 됩니다. 리턴 값이 0이 아니면 추적은 일부 레벨에서 활성이며 cci*Trace 함수를 호출하는 데 적절합니다. 추적 레벨의 세부사항이 필요한 경우에도 리턴 값을 자세히 검사할 수 있습니다.
추적 설정은 언제든지 변경할 수 있으므로 정기적으로 조회하는 것이 좋습니다. 예를 들어 cciIsTraceActive를 사용하여 구현 함수가 입력될 때 추적 설정을 조회하십시오.
추적 입력 항목은 추적 쓰기를 위해 자세히 제어할 수 있는 특정 오브젝트와 연관될 수 있습니다. 추적 입력 항목은 노드 또는 구문 분석기와 연관될 수 있으며 추적은 해당 오브젝트의 추적 설정에 따라 기록됩니다. 오브젝트의 추적 설정은 노드 또는 구문 분석기가 속한 메시지 플로우로부터 상속받습니다. 오브젝트가 지정되지 않은 경우 추적은 실행 그룹과 연관됩니다.