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
transporttransportICEconnectivity

iceState

Current ICE transport state for this transport.

Description

String enum (new, checking, connected, completed, failed, disconnected, closed)

The current state of the ICE transport, reflecting the ICE agent's connectivity checking process. The state progresses from "new" through "checking" as candidate pairs are tested, reaching "connected" when at least one working pair is found, and "completed" when all checks have finished.

Notes

  • "completed" means ICE has found a working pair and finished checking all candidates
  • "connected" means at least one working pair was found but checking may continue
  • "failed" means no working candidate pair could be found - often caused by restrictive firewalls or NAT configurations
  • "disconnected" may be transient and can recover