---
code: lua_sdk_debug
name: "实时调试"
wikiToken: RCKywXlqti3YDGkXrOIcKpjdnUd
parentWikiToken: PKA9w8heciZ4wCkyJoucMeaBnzh
updateTime: 1745309897000
sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=lua_sdk_debug
---
# 实时调试

::: warning 注意

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

:::

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

### 一、打印SDK日志

```
local tdAnalytics = require "ThinkingDataSdk"
-- enable log
TDAnalytics.enableLog(true)
```

### 二、开启 Debug 模式

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

1. 使用DebugConsumer
以下使用DebugConsumer的示例代码:

```
-- DebugConsumer:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
local tdAnalytics = require "ThinkingDataSdk"
local consumer = tdAnalytics.TDDebugConsumer("SERVER_URL", "APP_ID", false, "DeviceId")
local sdk = tdAnalytics(consumer)
--设置访客ID"ABCDEFG123456789"
local distinctId = "ABCDEFG123456789"
--设置账号ID"TE_10001"
local accountId = "TE_10001"
--设置事件属性
local properties = {}
--设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息，如果不设置的话，则默认不上报
properties["#ip"] = "192.168.1.1"
properties["#device_id"] = "te_device_id"
--上传事件，包含用户的访客ID与账号ID，请注意账号ID与访客ID的顺序，两者不能全部为空
sdk:track(accountId, distinctId, "payment", properties)
```

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

<!-- unsupported block: 34 -->

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