문제 해결¶

이 문서는 C++ SDK 초기화 이상, 데이터 미수신 및 호환성 문제에 대한 문제 해결 권장 사항을 제공합니다.

초기화 후 데이터가 없는 경우¶

다음 사항을 먼저 확인하세요:

1. 전제 조건에 명시된 DataKit 설치, 실제 사용자 모니터링(RUM) 수집기 구성 및 IP 지리 정보 라이브러리 설치가 완료되었는지 확인
2. FTSDKConfig.setServerUrl에 구성된 주소를 현재 디바이스에서 액세스할 수 있는지 확인
3. FTRUMConfig.setRumAppId가 올바르게 입력되었는지 확인
4. sdk->install(...), sdk->initRUMWithConfig(...) 및 해당 Log / Trace 초기화 메서드가 호출되었는지 확인
5. 프로그램 수명 주기 내에서 실제로 View, Action, Resource, Error, LongTask 또는 Log가 트리거되었는지 확인

디버그 로그 확인¶

ft_sdk_config.json을 통해 디버그 로그를 활성화할 수 있습니다:

{
  "general_config": {
    "enable_sdk_log": true
  }
}

최소한의 예제에서 먼저 SDK 초기화와 한 번의 수동 보고만 유지하여 기본 파이프라인이 정상인지 확인한 후, 점진적으로 비즈니스 로직을 추가하는 것을 권장합니다.

RUM 데이터 없음¶

다음 사항을 확인하세요:

• setRumAppId가 올바르게 설정되었는지 확인
• sdk->initRUMWithConfig(...)가 실행되었는지 확인
• RUM 수집 인터페이스가 수동으로 호출되었는지 확인 (자세한 내용은 사용자 정의 수집 규칙 참조)
• setSamplingRate가 0으로 설정되지 않았는지 확인

Log 또는 Trace 데이터 없음¶

다음 사항을 확인하세요:

• sdk->initLogWithConfig(...), sdk->initTraceWithConfig(...)가 각각 실행되었는지 확인
• Log에 대해 setEnableCustomLog(true)가 활성화되었는지 확인
• Trace에 대해 백엔드 추적 유형에 따라 올바른 setTraceType(...)이 설정되었는지 확인
• 로그 및 추적에서 RUM을 연결해야 하는 경우 setEnableLinkRUMData(true)를 활성화했는지 확인

호환성 설명¶

현재 C++ SDK 문서는 다음 플랫폼을 명시적으로 지원합니다:

• Windows
• Linux

현재 실행 환경이 위 범위에 속하지 않는 경우, 먼저 SDK 버전 및 플랫폼 지원 여부를 확인한 후 연동 방안을 평가하시기 바랍니다.

사용자 정의 필드 충돌¶

보고된 필드가 비정상이거나 덮어쓰여지는 경우, SDK 내장 필드와 이름이 중복되는지 확인하세요. 명명 규칙은 충돌 필드 설명을 참조하십시오.