Skip to main content

Real-time debugging

Last updated 10/03/2026

During SDK integration, you can debug in real time by viewing the SDK logs in the IDE console or by using the Debug feature of AE.

1. Print SDK logs​

TDAnalytics.enableLog(true)

After you enable logging, you can observe the SDK's data reporting in the IDE.

2. Enable Debug mode​

Enabling Debug mode takes the following two steps:

  1. Enable Debug mode on the client

The following sample code enables Debug mode on the client:

/*
Set the run mode to Debug mode
TDMode.NORMAL: Data is cached and reported according to a caching strategy. NORMAL is the default mode. Recommended for the production environment
TDMode.DEBUG: Data is reported one record at a time. Problems are reported to the user through logs and exceptions. Not recommended for the production environment
TDMode.DEBUG_ONLY: Data is only validated and not stored. Not recommended for the production environment
 */
let config = new TDConfig()
config.appId = 'appID'
config.serverUrl = 'serverUrl'
config.mode = TDMode.DEBUG
await TDAnalytics.initWithConfig(this.context, config)
  1. Add the Debug device in AE

To prevent Debug mode from going live in the production environment, Debug mode can only be enabled on specified devices. Debug mode can be enabled only on devices that have Debug mode enabled on the client and whose device IDs have been added on the Data → Tracking → Debugger page in the AE backend. To add a device, click Add test device in the upper-right corner of the page, click New device in the Select device drawer, and enter the device ID.

You can get the device ID in the following three ways:

  • The #device_id property in the event data on the TA platform
  • Client logs: The SDK prints the DeviceId after initialization completes
  • Call the instance API: Get the device ID

Debug mode may affect data collection quality and App stability. Use it only to verify data during integration, and don't use it in the production environment.

Was this page helpful?
On this page