Debug & Log

This guide will help you understand how to install debugging symbols and handle logging to assist in building your Discord Social SDK integration.

Debugging symbols are hosted at https://storage.googleapis.com/discord-public-symbols. If using Visual Studio, you can add this link to the pdb locations under Tools > Options > Debugging > Symbols.

You can access Discord's logs with Client::AddLogCallback. The Client::SetLogDir function will write the SDK's logs to that directory if set.

client->AddLogCallback([](auto message, auto severity) {
  std::cout << "[" << EnumToString(severity) << "] " << message << std::endl;
}, discordpp::LoggingSeverity::Info);

The voice subsystem (including the underlying WebRTC infrastructure) has its own dedicated logging separate from the main SDK log stream. You have two options:

• Client::SetVoiceLogDir — writes voice logs to disk in the specified directory.
• Client::AddVoiceLogCallback — delivers voice log messages to a callback in your application.

These can be used together, but Client::SetVoiceLogDir must be called immediately after Client construction, before any call that initializes the voice subsystem (including Client::AddVoiceLogCallback). Calling it after the voice subsystem has started has no effect.

// Must be called right after constructing the client, before anything else
client->SetVoiceLogDir("/path/to/log/dir", discordpp::LoggingSeverity::Info);

// Can be called any time after construction
client->AddVoiceLogCallback([](auto message, auto severity) {
  std::cout << "[Voice][" << EnumToString(severity) << "] " << message << std::endl;
}, discordpp::LoggingSeverity::Info);

For diagnosing issues with acoustic echo cancellation (AEC), you can use the Client::SetAecDump function. This enables diagnostic recording of audio input and output waveform data, which can be invaluable when troubleshooting echo, feedback, or other audio processing problems.

Client::SetAecDump Enables or disables AEC diagnostic recording. When enabled, the input and output waveform data will be written to the log directory (the same directory specified by Client::SetLogDir).

// Enable AEC diagnostic recording
client->SetAecDump(true);

// ... perform voice chat operations to reproduce the issue ...

// Disable AEC diagnostic recording when done
client->SetAecDump(false);

When to use:

• Users report echo or feedback during voice chat
• Audio quality issues that may be related to echo cancellation
• Testing AEC performance in different environments
• Debugging audio processing pipeline issues

The Discord client now includes some built-in developer tools to help you diagnose issues and test some of the features of the Discord Social SDK. To enable these new tools, navigate to Settings > Advanced and toggle on Application Test Mode. For the purposes of this guide, enter your Application ID and ignore the rest of the options in this modal, then click Activate. Once you've enabled Application Test Mode, you should see a new wrench icon in the upper right corner of your client. Click on this to open the developer tools.

This tab shows you the status of each of the on-platform account linking flows as well as provides a quick option to start the account linking flow without needing to find one of the entry points within the client. For more information on each of the flows, read the Account Linking from Discord guide.

Need help? Join the Discord Developers Server and share questions in the #social-sdk-dev-help channel for support from the community.

If you encounter a bug while working with the Social SDK, please report it here: https://dis.gd/social-sdk-bug-report