Real-time debugging

Last updated 10/02/2026

Note

The SDK Debug mode is only for debugging during integration. Never use it in the production environment.

Enable log printing

TDLog::enable = true;

Use TDDebugConsumer

During SDK integration, you can use the AE Debug feature for real-time debugging. To use the Debug feature, complete the following two steps:

1. Use TDDebugConsumer

The following sample code uses TDDebugConsumer:

string deviceId = "123456789";
TDDebugConsumer debugConsumer("appId", "serverUrl", "", deviceId);
TDAnalytics te(debugConsumer);

TDPropertiesNode event_properties;
event_properties.SetString("name", "value");
// track an event
te.track("accountId", "distinctId", "eventName", event_properties);

2. Add a Debug device in the AE backend

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.

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.