문제 해결¶

SDK 초기화 이상¶

일반 uni-app¶

1. GC-JSPlugin과 GC-UniPlugin이 모두 0.3.0 이상이며, 버전 번호가 일치하고 동일한 릴리스 패키지에서 제공되었는지 확인합니다.
2. 애플리케이션 진입점에서 JS 수집기를 처음 사용하기 전에 GC-UniPlugin/setup.js를 로드했는지 확인합니다.
3. SDK API가 GC-UniPlugin에서 가져오고, JS 수집기가 GC-JSPlugin에서 가져오는지 확인합니다.
4. 프로젝트에 기존 nativeplugins/GCUniPlugin 및 해당 manifest.json 구성이 없는지 확인합니다.
5. datakitUrl 또는 datawayUrl + clientToken 구성이 유효한지 확인합니다.

uni 미니프로그램¶

1. uni 미니프로그램 프로젝트는 GC-JSPlugin만 설치하고, GC-UniPlugin 또는 setup.js를 가져오지 않습니다.
2. 호스트 앱이 uni 미니프로그램을 열기 전에 Native SDK 초기화를 완료합니다.
3. 호스트가 GCUniPlugin-MobileAgent, GCUniPlugin-RUM, GCUniPlugin-Logger, GCUniPlugin-Tracer를 등록했습니다.
4. 일반 디버깅 베이스에 호스트 모듈이 없는 경우, 공용 API는 안전하게 널 연산으로 대체되므로 기본 데이터가 업로드되지 않습니다. 실제 호스트 앱에서 통합 테스트를 완료하세요.

Debug 디버깅 활성화¶

일반 uni-app:

import { mobileAgent } from '@/uni_modules/GC-UniPlugin';

mobileAgent.sdkConfig({
    datakitUrl: 'YOUR_DATAKIT_URL',
    debug: true
});

uni 미니프로그램은 호스트 앱에서 Native SDK Debug 구성을 활성화하며, JS 측에서 sdkConfig()를 중복 호출하지 않습니다.

정식 버전을 릴리스하기 전에 Debug를 비활성화하는 것이 좋습니다.

SDK는 정상적으로 실행되지만 데이터가 없음¶

• Datakit 문제 해결에서 Datakit가 정상적으로 실행되는지 확인합니다.
• SDK 업로드 주소 구성이 올바른지 확인하고, Debug 로그의 동기화 결과를 확인합니다.
• RUM 초기화에 현재 플랫폼에 해당하는 App ID가 사용되었는지 확인합니다.
• 현재 네트워크에서 Datakit 또는 DataWay에 접근할 수 있는지 확인합니다.
• uni 미니프로그램 시나리오의 경우 호스트 앱 초기화가 완료된 후에만 uni 미니프로그램을 열어야 합니다.

데이터 손실¶

• RUM, Log, Trace에서 sampleRate < 1이 구성되었는지 확인합니다.
• Resource와 Action은 유효한 View와 연결되어야 합니다. 자동 또는 수동 방식으로 startView가 호출되었는지 확인합니다.
• iOS에서 enableNativeUserResource를 활성화한 경우, gcResourceTracking.startTracking({ enableIOS: false })를 사용하여 동일한 요청이 중복 수집되지 않도록 합니다.
• gcViewTracking과 이전 버전의 View mixin을 동시에 활성화하여 동일한 페이지를 수집하지 않도록 합니다.
• 디바이스 네트워크, Datakit 부하 및 로컬 캐시 제한을 확인합니다.

추가 관련 내용¶

• Android 문제 해결
• iOS 문제 해결