Logging

Show Contents

Native logs are often valuable in order to debug issues that can’t be easily reproduced. Following are instructions for gathering logs on various platforms.

Chrome

Running Chrome with the following command line flags will turn on INFO and VERBOSE logging for WebRTC:

chrome --enable-logging --vmodule=*/webrtc/*=1

More details on Chrome logging can be found here.

The log will be named ‘chrome_debug.log’ and saved in the Chrome user data directory.

Native applications

To enable native logs for a native application, you can either:

  • Use a debug build of WebRTC (a build where NDEBUG is not defined), which will enable INFO logging by default.

  • Call rtc::LogMessage::LogToDebug(rtc::LS_INFO) within your application. Or use LS_VERBOSE to enable VERBOSE logging.

For the location of the log output on different platforms, see below.

Android

Logged to Android system log. Can be obtained using:

adb logcat -s "libjingle"

iOS

Only logged to stderr by default. To log to a file, use RTCFileLogger.

Mac

For debug builds of WebRTC (builds where NDEBUG is not defined), logs to stderr. To do this for release builds as well, set a boolean preference named ‘logToStderr’ to true for your application. Or, use RTCFileLogger to log to a file.

Windows

Logs to the debugger and stderr.

Linux/Other Platforms

Logs to stderr.