139
edits
Media/WebRTC/WebRTC Debugging: Difference between revisions
Adding RTPLogger information
(Fix syntax highlight name) |
(Adding RTPLogger information) |
||
| Line 14: | Line 14: | ||
==Logging== | ==Logging== | ||
Logging can be enabled through the "Enable WebRTC Log Preset" button at the bottom of [about:webrtc]. Alternatively one can set the following environment variable:<syntaxhighlight lang="sh">MOZ_LOG="jsep:5,sdp:5,signaling:5,mtransport:5,RTCRtpReceiver:5,RTCRtpSender:5,RTCDMTFSender:5,VideoFrameConverter:5,WebrtcTCPSocket:5,CamerasChild:5,CamerasParent:5,VideoEngine:5,ShmemPool:5,TabShare:5,MediaChild:5,MediaParent:5,MediaManager:5,MediaTrackGraph:5,cubeb:5,MediaStream:5,MediaStreamTrack:5,DriftCompensator:5,ForwardInputTrack:5,MediaRecorder:5,MediaEncoder:5,TrackEncoder:5,VP8TrackEncoder:5,Muxer:5,GetUserMedia:5,MediaPipeline:5,PeerConnectionImpl:5,WebAudioAPI:5,webrtc_trace:5,RTCRtpTransceiver:5,ForwardedInputTrack:5,HTMLMediaElement:5,HTMLMediaElementEvents:5"</syntaxhighlight> Note that webrtc_trace will not be active until "Enable WebRTC Log Preset" is pressed. | Logging can be enabled through the "Enable WebRTC Log Preset" button at the bottom of [about:webrtc]. Alternatively one can set the following environment variable:<syntaxhighlight lang="sh">MOZ_LOG="jsep:5,sdp:5,signaling:5,mtransport:5,RTCRtpReceiver:5,RTCRtpSender:5,RTCDMTFSender:5,VideoFrameConverter:5,WebrtcTCPSocket:5,CamerasChild:5,CamerasParent:5,VideoEngine:5,ShmemPool:5,TabShare:5,MediaChild:5,MediaParent:5,MediaManager:5,MediaTrackGraph:5,cubeb:5,MediaStream:5,MediaStreamTrack:5,DriftCompensator:5,ForwardInputTrack:5,MediaRecorder:5,MediaEncoder:5,TrackEncoder:5,VP8TrackEncoder:5,Muxer:5,GetUserMedia:5,MediaPipeline:5,PeerConnectionImpl:5,WebAudioAPI:5,webrtc_trace:5,RTCRtpTransceiver:5,ForwardedInputTrack:5,HTMLMediaElement:5,HTMLMediaElementEvents:5"</syntaxhighlight> Note that webrtc_trace will not be active until "Enable WebRTC Log Preset" is pressed. | ||
===Standard Logging Modules=== | |||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|- | |- | ||
| Line 88: | Line 89: | ||
| HTMLMediaElementEvents || ?? || ? || | | HTMLMediaElementEvents || ?? || ? || | ||
|- | |- | ||
|} | |||
===Non-standard Logging Modules=== | |||
{| class="wikitable sortable" | |||
|- | |||
! Module !! Component !! Function !! Notes | |||
|- | |||
| RTPLogger || network || See [[#Debugging_Encrypted_Packets|Debugging Encrypted Packets]] | |||
|} | |} | ||
==Profiling== | ==Profiling== | ||
| Line 97: | Line 105: | ||
==Dumping Call Stats== | ==Dumping Call Stats== | ||
One can dump a JSON blob of call stats for an active call, or a recent call if call stats history is enabled. There are two buttons in [about:webrtc] to do this, "Copy Report" and "Copy Report History". The former will create a copy of the most recent stats for the PeerConnection. The later will copy all the history of stats reports that [about:webrtc] has accumulated for that PeerConnection, this can be up to several minutes of stats. | One can dump a JSON blob of call stats for an active call, or a recent call if call stats history is enabled. There are two buttons in [about:webrtc] to do this, "Copy Report" and "Copy Report History". The former will create a copy of the most recent stats for the PeerConnection. The later will copy all the history of stats reports that [about:webrtc] has accumulated for that PeerConnection, this can be up to several minutes of stats. | ||
== | ==Debugging Encrypted Packets== | ||
There is a [https://blog.mozilla.org/webrtc/debugging-encrypted-rtp-is-more-fun-than-it-used-to-be/ blog post] covering dumping unencrypted partial RTP and RTCP packets in the logs. This allows one to manipulate those log statements into something that [https://www.wireshark.org/ Wireshark] can read. The command to extract the packet data in the blog is out of date. The logs produced by this module can be quite large, making it easy to identify by file size which child log file(s) contains the dump(s). Use the following command instead <syntaxhighlight lang="sh">TODO</syntaxhighlight>. | |||
==Running WebRTC Tests== | ==Running WebRTC Tests== | ||
==Debugging Using 3rd Party Websites== | ==Debugging Using 3rd Party Websites== | ||
==Using RR And/Or Pernosco== | ==Using RR And/Or Pernosco== | ||