WebRTC Metrics
A comprehensive overview of WebRTC statistics, derived indicators, and observable signals, to better understand call quality, connectivity, and user experience in rtcStats
Back
transporttransportsecurityDTLS
dtlsState
Current DTLS transport connection state.
Description
String enum (new, connecting, connected, closed, failed)
Represents the current state of the DTLS transport used to secure the media. The DTLS handshake must complete before encrypted media can flow. The state transitions from "new" through "connecting" to "connected" during a successful session setup, or to "failed" if the handshake cannot complete.
See also
- transport->tlsVersion
- transport->dtlsCipher
- WebRTC Statistics Specification

Notes
- A "failed" state indicates the DTLS handshake could not complete - common causes include certificate mismatch, network interruption during handshake, or firewall blocking
- "connected" is the normal operating state during an active session