Stream Health Monitoring Using the Kaltura Live Dashboard (beta)

Printer-friendly version
Audience / Tech Expertise: 

Stream Health represents how Kaltura Live servers sense the ingested stream health from the customer encoder. By exposing the stream health, the Kaltura Live Dashboard provides users visibility to potential issues with their live streams and provides additional information that helps to identify and resolve some common live streaming issues.

By hovering over the "?" (question mark) a tooltip is displayed with a message and one of the following statuses:
"Stream Health indicates how your live stream is being received by Kaltura.

The stream health values are:

  • Good - Live stream is healthy. 
  • Fair - Viewers may experience minor issues
  • Poor - Viewers potentially experience serious viewing issues
  • N/A - Kaltura is not receiving data.

The System Health is subject to change based on various conditions and are continuously monitored and updated in the dashboard (every 10 seconds)

System Health Statuses and Error Messages

Most of the issues that may impede live streaming happen due to insuffecient bandwidth/network or encoder configuration. Click here for more information about Kaltura live stream requirements.  Use the speed-test links in this article to measure your available bandwidth.

The following table indicates stream health statuses in the Kaltura Live Dashboard and their repspective error messages:

 

Stream Health

Description

Effect on Viewers

Action

POOR

Incoming video rate is too slow. Kaltura is not receiving enough data to maintain smooth streaming. 

Viewers may experience video freeze, or buffering problems.

Check the encoder CPU, available bandwidth and consider reducing the bitrate in your encoder configuration.

POOR

Video/Audio track has been dropped from your broadcast.

Viewers will stop receiving the dropped audio/video track. Playback may be interrupted. 

Check the encoder CPU and logs

FAIR

Encoder re-connection occurred.

Viewers may experience buffering problems.

Check your available bandwidth and connectivity to  the Kaltura cloud.

FAIR

Incoming streams are not in sync. 

Viewers may experience video/audio sync issues and/or artifacts when moving between video flavors.

Check your encoder configuration and make sure all the keyframes in your streams are aligned.

FAIR

Duplicated frames detected. 

Viewers may experience degraded video quality 

Check your encoder CPU load and logs.

GOOD

Detected incoming actual bitrate (value) is different from declared one (value). 

No effect.

Make sure your encoder is configured to use CBR (constant bitrate).

GOOD

High FPS detected ([value]). Recommended value is up to 30 frames per second.

Viewers on old non-HTML5 browsers may experience quality issues

Configure your encoder to use up to 30 Frames Per Second.

GOOD

Detected key frame interval/GOP length is [value] seconds. Recommended value is 2 seconds.

No effect.

Configure you encoder to use 2 seconds key-frame interval (or 60 GOP length/duration).

GOOD

Encoder start detected.

Viewers wlll start receiving video.

 

GOOD

Encoder stop detected.

Viewers will stop receiving video.

 

Document type: 
(1957 reads)