실시간 디버깅

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

1. SDK 로그 출력

-- 로그 출력 활성화
-- logLevelNone: 로그 출력 끄기
-- logLevelError: 오류 로그 출력
-- logLevelInfo: 상세 로그 출력
-- logLevelDebug: 디버그 로그 출력
TDAnalytics.setLogLevel(TDAnalytics.logLevel.logLevelDebug)

로그를 활성화한 후 IDE에서 ThinkingData 관련 로그를 필터링하여 SDK의 데이터 전송을 확인할 수 있습니다.

2. 디버그 모드 활성화

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

1. 클라이언트에서 디버그 모드 활성화

다음은 클라이언트에서 디버그 모드를 활성화하는 예시 코드입니다:

--[[
실행 모드를 Debug 모드로 설정
debugOff 모드: 데이터를 캐시에 저장하고 일정한 캐시 전략에 따라 전송하며, 기본값은 debugOff 모드입니다. 운영 환경에서 사용을 권장합니다
debugOn 모드: 데이터를 한 건씩 전송합니다. 문제가 발생하면 로그와 예외로 사용자에게 알립니다. 운영 환경에서는 사용을 권장하지 않습니다
debugOnly 모드: 데이터 검증만 하고 적재하지 않습니다. 운영 환경에서는 사용을 권장하지 않습니다
]]
TDAnalytics.init(APP_ID, SERVER_URL, TDAnalytics.debugModel.debugOn)

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

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

디바이스 ID는 다음 세 가지 방법으로 확인할 수 있습니다:

• AE 플랫폼 이벤트 데이터의 #device_id 속성
• 클라이언트 로그: SDK 초기화가 완료되면 디바이스 DeviceId가 출력됩니다
• 인스턴스 인터페이스 호출: 디바이스 ID 가져오기

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