实时调试

最近更新 2026/10/02

注意

SDK Debug 模式仅供接入调试时使用，严禁应用在生产环境。

在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用AE的Debug功能，进行实时调试。

一、打印SDK日志

ThinkingData.enableLog(true);

二、开启 Debug 模式

开启Debug模式需要如下两步操作:

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后台添加Debug设备

为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的「数据 → 埋点管理 → Debug 模式」页面中添加了的设备才能开启 Debug 模式。添加方法：点击页面右上角「接入设备」，在「选择设备」抽屉里点击「添加设备」，填入设备 ID。

Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。