CallMeter Docs

Video Freeze Events

Understand video freeze event counting — how CallMeter detects frozen video, thresholds, and what freeze events mean for the viewer experience.

Video Freeze Events counts the number of times the video froze during a call. A freeze occurs when the video decoder cannot render new frames, causing the last successfully decoded frame to remain stuck on screen. Each freeze event represents a distinct moment where the viewer saw a motionless, stuck image instead of live video.

This is the single most user-visible video quality problem. A viewer may tolerate lower resolution or frame rate drops, but a frozen picture is immediately obvious and disruptive.

How It Works

CallMeter monitors the video decoder's frame output. When the decoder stops producing new frames for a detectable period, a freeze event is recorded. The freeze continues until the decoder receives enough data (typically a keyframe) to resume rendering.

Each freeze event is counted once, regardless of duration. A half-second freeze and a five-second freeze both count as one event. For duration measurement, see Video Freeze Duration.

Distinct from low FPS

A freeze is not the same as low frame rate. At 10 fps, the video is choppy but still moving. During a freeze, the video stops completely — the same frame stays on screen until recovery. CallMeter distinguishes between these two conditions.

Why It Matters

Video freezes have an outsized impact on perceived quality. Research consistently shows that users rate a call with freezes significantly worse than a call with uniformly lower quality. A single freeze event breaks the sense of real-time presence that video calls depend on.

For enterprise VoIP testing, freeze count is a critical pass/fail metric:

  • Load testing — Freeze count at scale reveals the capacity ceiling of your video infrastructure
  • Network qualification — Freezes during baseline testing indicate the network is not suitable for video
  • Codec evaluation — Comparing freeze counts across codec configurations helps select the most resilient option
  • Regression testing — Any increase in freeze count after infrastructure changes indicates a regression

Thresholds

LevelFreeze CountInterpretation
Good0No freezes, smooth video throughout
Warning1 - 3Occasional freezes, noticeable but tolerable
CriticalAbove 3Frequent freezes, severely degraded experience

Common Causes of Video Freezes

CauseExplanation
Burst packet lossMultiple consecutive video packets lost, making frames undecodable
Keyframe lossA keyframe is lost, and the decoder cannot recover until the next one
Network congestion spikeSudden bandwidth reduction causing the decoder to starve
Jitter buffer underflowBuffer runs empty, no frames available to render
CPU overload on decoderDecoder cannot process frames fast enough to maintain output

How to Fix It

  1. Identify the cause — Correlate freeze timing with Packet Loss Rate, Video Bitrate, and Jitter to determine what triggered each freeze.
  2. Enable NACK retransmissionNACK-based recovery can recover lost packets before they cause a freeze.
  3. Shorten keyframe interval — Reduce the Keyframe Interval so recovery from corruption happens faster, limiting freeze duration.
  4. Increase bandwidth headroom — Video needs consistent bandwidth, not just average capacity. Add 30% headroom above the target bitrate.
  5. Improve QoS — Apply DSCP marking and traffic shaping to protect video from competing traffic.

On this page