# 实时调试
# 一、打印SDK日志
-- 开启打印日志
ThinkingAnalyticsAPI.shareInstance(params)
local params = {
appId = "YOUR_APP_ID",
serverUrl = "YOUR_SERVER_URL",
enableLog = true, -- true=开启打印日志, false=关闭打印日志
}
ThinkingAnalyticsAPI.shareInstance( params )
打开日志后,可以在IDE中过滤 ThinkingAnalytics 相关的日志来观察 SDK 的数据上报。
# 二、开启 Debug 模式
开启Debug模式需要如下两步操作:
- 客户端开启Debug模式
以下是客户端开启Debug模式的示例代码:
--[[
设置运行模式为 Debug 模式
normal模式:数据会存入缓存,并依据一定的缓存策略上报,默认为NORMAL模式;建议在线上环境使用
debug模式:数据逐条上报。当出现问题时会以日志和异常的方式提示用户;不建议在线上环境使用
debugOnly模式:只对数据做校验,不会入库;不建议在线上环境使用
]]--
local params = {
appId = "YOUR_APP_ID",
serverUrl = "YOUR_SERVER_URL",
debugMode = "debug", -- normal, debug, debugOnly
}
ThinkingAnalyticsAPI.shareInstance( params )
- TA后台添加Debug设备
为了避免 Debug 模式在生产环境上线,规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式,并且设备 ID 在 TA 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
设备 ID 可以通过以下三种方式获取:
- TA 平台中事件数据中的 #device_id 属性
- 客户端日志:SDK 初始化完成后会打印设备 DeviceId
- 通过实例接口调用:获取设备ID
Debug 模式可能会影响数据采集质量和 App 的稳定性,只用于集成阶段数据验证,不要在线上环境使用。