menu
Is this helpful?

# 实时调试

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

# 一、打印SDK日志

在 TDAnalytics 插件中勾选 Enable Log 即可

打开日志后,可以在 IDE 中过滤 TDAnalytics 相关的日志来观察 SDK 的数据上报。

# 二、开启 Debug 模式

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

  1. 客户端开启 Debug 模式

在 TDAnalytics 插件中设置 SDK MODE 为 Debug 即可。

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

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

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

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

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