summaryrefslogtreecommitdiffstats
path: root/third_party/libwebrtc/docs/native-code/logging.md
blob: 1daadbe2b5306c42bcb891567136124bd3f9acda (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
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.

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:

~~~~ bash
adb logcat -s "libjingle"
~~~~

To enable the logging in a non-debug build from Java code, use
`Logging.enableLogToDebugOutput(Logging.Severity.LS_INFO)`.

#### 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`.