트러블슈팅¶
SDK 초기화 이상 검증¶
Logcat에서 Level이 Error이고, Tag가 [FT-SDK] 접두사인 로그가 있는지 확인합니다.
SDK 내부에서는 assert를 사용하여 여러 설정의 정확성을 검사하며, 설정이 잘못된 경우 프로그램이 크래시되고 관련 경고가 출력됩니다. 하지만 기본적으로 Debug 환경에서만 적용되므로, 오프라인 패키징 프로젝트를 사용하여 사용자 정의 디버그 베이스 제작을 권장하며, Release 환경에서도 동일하게 적용되도록 설정합니다.
project -> target -> Build Settings를 클릭하고, 검색창에서 ENABLE_NS_ASSERTIONS를 검색한 후 Release를 Yes로 변경합니다.
디버그 베이스에서만 설정할 것을 권장하며, 일반 패키지 배포 시에는 기본 설정을 사용합니다.
위 구성을 수행하지 않은 경우, Debug 디버그 활성화를 통해 「콘솔」의 디버그 로그를 확인하여 SDK 초기화 성공 여부를 판단할 수도 있습니다.
Debug 디버그 활성화¶
다음 구성을 통해 SDK의 debug 기능을 활성화할 수 있습니다.
var ftMobileSDK = uni.requireNativePlugin("GCUniPlugin-MobileAgent");
ftMobileSDK.sdkConfig({
'serverUrl': SDKConst.SERVER_URL,
'debug': true,
});
버전 출시 시에는 이 구성을 비활성화할 것을 권장합니다.
Logcat에서 Tag가 [FT-SDK] 접두사인 로그를 확인합니다.
Mac의 「콘솔」에서 SDK 디버그 로그를 확인합니다.
「콘솔」 사용법:
동작을 선택하고 정보 메시지 포함, 디버그 메시지 포함을 체크합니다.
디버그할 장치를 선택하고 시작 버튼을 클릭한 후, 오른쪽 검색 조건 입력란에 [FTLog] 를 입력합니다. 그러면 SDK의 디버그 로그를 확인할 수 있습니다.
Android Logcat 및 iOS Xcode Console 로그 예시
SDK는 정상 실행되지만 데이터가 없음¶
-
Datakit가 정상 실행 중인지 확인합니다.
-
SDK 업로드 주소
serverUrl이 올바르게 설정되었고, 정상적으로 초기화되었는지 확인합니다. debug 모드에서 Android Logcat 또는 iOS Xcode Console의 동기화 로그를 확인합니다. -
Datakit가 해당 워크스페이스로 데이터를 업로드하고 있는지, 오프라인 상태인지 확인합니다. 이는 Guance에 로그인하여 「인프라」를 확인함으로써 파악할 수 있습니다.
데이터 손실¶
일부 데이터 손실¶
-
RUM의 특정 Session 데이터나 Log, Trace의 일부 데이터가 손실된 경우, 먼저 RUM 설정, Log 설정, Trace 설정에서
samplerate < 1로 설정되지 않았는지 확인합니다. -
수집된 RUM 데이터가 불완전하여 Resource 또는 Action 데이터가 없습니까?
Resource 및 Action 데이터는 View와 바인딩되어 있으므로, - startView 작업이 있는지 확인해야 합니다. RUM-View 문서를 참조하여 View 이벤트 수집을 구현할 수 있습니다.
-
데이터 업로드 장치의 네트워크와 Datakit 설치 장치의 네트워크 및 부하 문제를 점검합니다.