실시간 디버깅

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

주의

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

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

1. DebugConsumer 사용

다음은 DebugConsumer를 사용하는 예시 코드입니다.

%% 수집 주소 설정
ServerUrl = "server_url",
%% app_id 설정
AppID = "app_id",
%% 데이터베이스 기록 여부 설정
IsWrite = true,
%% device_id 설정. AE 백엔드에서 전송된 데이터를 실시간으로 확인하는 데 사용
DeviceId = "123456789",

%% init consumer
Consumer = td_debug_consumer:init_with_config(ServerUrl, AppID, IsWrite, DeviceId),
%% init SDK with consumer
TE_SDK = td_analytics:init_with_consumer(Consumer),

AccountId0 = "account_id_Erlang_0",

%% ordinary event
td_analytics:track_instance(TE_SDK, AccountId0, "distinct_logbus", "ViewProduct", #{"#key_1" => "🚓🦽🦼🚲🚜🚜🦽", "key_2" => 2.2, "key_array" => ["🚌", "🏍", "😚😊"]}),

%% SDK를 종료할 때 호출해야 함. 종료한 후 SDK를 다시 활성화하려면 위의 초기화 코드를 반드시 다시 실행해야 함
td_analytics:close_instance(TE_SDK).

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

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

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