menu
Is this helpful?

# 实时调试

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

# 一、打印SDK日志

可以在SDK初始化时设置showLog为true,打开SDK日志开关,打开后将会在浏览器控制台打印上报的数据。

var config = {
    appId: "xxx",
    serverUrl: "xxx",
    showLog:true
};

# 二、 Debug 模式

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

  1. 客户端开启Debug模式

可以在SDK初始化时设置时开启Debug模式:

var config = {
    appId: "xxx",
    serverUrl: "xxx",
    /*normal模式:数据会存入缓存,并依据一定的缓存策略上报,默认为NORMAL模式;建议在线上环境使用
      debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户;不建议在线上环境使用
      debug_only模式:只对数据做校验,不会入库;不建议在线上环境使用
    */
    mode:"debug"
};
  1. TE 后台添加Debug设备

为了避免 Debug 模式在生产环境上线,规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式,并且设备 ID 在 TE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。

设备 ID 可以通过以下三种方式获取:

  • TE 平台中事件数据中的 #device_id 属性
  • 客户端日志:SDK 初始化完成后会打印设备 DeviceId
  • 通过实例接口调用:获取设备ID

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