실시간 디버깅

최근 업데이트 2026. 10. 02.

주의

SDK 디버그 모드는 연동 디버깅에만 사용하며, 운영 환경에서는 절대 사용하지 마십시오.

SDK 연동 과정에서 IDE 콘솔에 출력되는 SDK 로그를 확인하거나 AE의 Debug 기능을 사용하여 실시간으로 디버깅할 수 있습니다.

1. SDK 로그 출력

ThinkingData.enableLog(true);

2. 디버그 모드 활성화

디버그 모드를 활성화하려면 다음 두 단계를 진행해야 합니다:

1. DebugMode 사용

다음은 DebugMode를 사용하는 예시 코드입니다:

/*
DebugMode: 데이터를 한 건씩 전송합니다. 문제가 발생하면 로그와 예외로 사용자에게 알립니다. 운영 환경에서는 사용을 권장하지 않습니다
 */
let teSDK = ThinkingData.initWithDebugMode('appId', 'serverUrl', {
    dryRun: false, // report data to TE or not
    deviceId: "123456789"
});

let trackEvent = {
    accountId: '2222',
    distinctId: '1111',
    event: 'test_event',
    time: new Date(),
    ip: '202.38.64.1',
    properties: {
        prop_double: 134.1,
    },
    callback(e) {
        if (e) {
            console.log(e);
        }
    }
};

teSDK.track(trackEvent)

2. AE 백엔드에 디버그 디바이스 추가

디버그 모드가 운영 환경에 배포되는 것을 막기 위해 지정된 디바이스에서만 디버그 모드를 활성화할 수 있도록 제한합니다. 클라이언트에서 디버그 모드를 활성화했고, 디바이스 ID가 AE 백엔드의 데이터 → 트래킹 관리 → 디버그 모드 페이지에 추가된 디바이스만 디버그 모드를 활성화할 수 있습니다. 추가 방법: 페이지 오른쪽 상단의 디바이스 연동을 클릭하고 디바이스 선택 드로어에서 디바이스 추가를 클릭한 후 디바이스 ID를 입력합니다.

디버그 모드는 데이터 수집 품질과 App의 안정성에 영향을 줄 수 있으므로 연동 단계의 데이터 검증에만 사용하고 운영 환경에서는 사용하지 마십시오.