실시간 디버깅

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

주의

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

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

1. SDK 로그 출력

TDAnalytics.enableLog(isPrint=True)

2. 실시간 디버깅

SDK 연동 과정에서 AE의 디버그 기능을 사용하여 실시간으로 디버깅할 수 있습니다. 디버그 기능을 사용하려면 다음 두 단계가 필요합니다.

1. TDDebugConsumer 사용

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

te = TDAnalytics(TDDebugConsumer("https://receiver-ta-demo.thinkingdata.cn", "appId", device_id="123456789"))
distinct_id = "ABD"
account_id = "11111"
try:
    te.track(account_id=account_id, event_name='event_name', properties={'level': 0})
except Exception as e:
    print(e)

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

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

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