Configuration Issues for LiveStream Resources

In a liveStream resource, the status.healthStatus.configurationIssues[] object contains a list of configuration issues affecting the stream. This information is intended to help you identify, diagnose, and resolve issues affecting the quality of your live video streams.

This document lists the types of configuration issues that might be referenced in an API response. Each issue specifies the issue type, a short description of the error, and a longer description that often contains information explaining how to fix the error.

Configuration Issues

The table below lists configuration issues that can affect live video streams. The left column identifies the type of issue and the right column provides additional detail about how to resolve it.

Note that some descriptions contain variables, which will be populated to reflect data about your actual live stream. In the descriptions below, text in <code> style, such as %(actual_gop).1f, identifies a portion of an error message that is customized to each live stream. Your code should be keyed off of the issue types, which are in the left column.

Configuration issues
audioBitrateHigh
Reason:Check audio settings
Description:The audio stream's current bitrate of %(actual) is higher than the recommended bitrate. We recommend that you use an audio stream bitrate of %(expected)s.
audioBitrateLow
Reason:Check audio settings
Description:The audio stream's current bitrate (%(actual)s) is lower than the recommended bitrate. We recommend that you use an audio stream bitrate of %(expected)s.
audioBitrateMismatch
Reason:Check secondary stream
Description:In the current configuration, the video's primary and backup streams have different audio bitrates. You need to configure the streams to have the same audio bitrate.
audioCodec
Reason:Check audio settings
Description:The audio stream is encoded with an unsupported codec. Please set the audio codec for the stream to a supported codec (AAC, MP3).
audioCodecMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams use different audio codecs. You need to configure the streams to use the same audio codec.
audioSampleRate
Reason:Check audio settings
Description:The current sample rate is %(actual). The recommended sample rates are 44.1kHz and 48kHz.
audioSampleRateMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams have different audio sample rates. You need to configure the streams to have the same audio sample rate.
audioStereoMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams use different audio channels. You need to configure the streams to have the same audio channel.
audioTooManyChannels
Reason:Check audio settings
Description:The audio has more than two channels, but only one (mono) or two (stereo) channels are supported. Please correct the number of audio channels.
badContainer
Reason:Bad video settings
Description:Please change the video's container format. The current container format is not correct for this configuration.
bitrateHigh
Reason:Check video settings
Description:The stream's current bitrate (%(actual)s) is higher than the recommended bitrate. We recommend that you use a stream bitrate of %(expected)s.
bitrateLow
Reason:Video output low
Description:The stream's current bitrate (%(actual)s) is lower than the recommended bitrate. We recommend that you use a stream bitrate of %(expected)s.
framerateMismatch
Reason:Check secondary stream
Description:In the current configuration, the video's primary and backup streams have different framerates. You need to configure the streams to have the same framerate.
frameRateHigh
Reason:Framerate high
Description:The current framerate is too high. Please set the framerate to %(framerate)s fps or less.
gopMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams have different keyframe frequencies. You need to configure the streams to have the same keyframe frequency.
gopSizeLong
Reason:Bad video settings
Description:Please use a keyframe frequency of four seconds or less. Currently, keyframes are not being sent often enough, which will cause buffering. The current keyframe frequency is %(actual_gop).1f seconds. Note that ingestion errors can cause incorrect GOP (group of pictures) sizes.
gopSizeOver
Reason:Check video settings
Description:Please use a keyframe frequency of four seconds or less. Currently, keyframes are not being sent often enough, which can cause buffering. The current keyframe frequency is %(actual_gop).1f seconds. Note that ingestion errors can cause incorrect GOP (group of pictures) sizes.
gopSizeShort
Reason:Check video settings
Description:The GOP (group of pictures) size is very small, which can reduce image quality. The recommended keyframe frequency is four seconds. The current keyframe frequency is %(actual_gop).1f seconds. Note that ingestion errors can cause incorrect GOP sizes.
multipleAudioStreams
Reason:Check audio settings
Description:The ingestion stream contains multiple audio streams, but it must only contain one audio stream.
multipleVideoStreams
Reason:Bad video settings
Description:The ingestion stream contains multiple video streams, but it must only contain one video stream.
noAudioStream
Reason:No audio
Description:The ingestion stream does not contain any audio streams, but it must contain exactly one audio stream.
noVideoStream
Reason:No video
Description:The ingestion stream does not contain any video streams, but it must contain exactly one video stream.
openGop
Reason:Bad video settings
Description:Please change your video encoder's configuration to "closed group of pictures (GOP)." It appears to be set to "open GOP," which YouTube does not support.
resolutionMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams have different resolutions. You need to configure the streams to have the same resolution.
videoBitrateMismatch
Reason:Check secondary stream
Description:In the current configuration, the video's primary and backup streams have different video bitrates. You need to configure the streams to have the same video bitrate.
videoCodec
Reason:Bad video settings
Description:The video is encoded with an unsupported codec. Please set the video codec for the stream to a supported codec (H.264).
videoCodecMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams use different video codecs. You need to configure the streams to have the same video codecs.
videoIngestionStarved
Reason:Video output low
Description:YouTube is not receiving enough video to maintain smooth streaming. As such, viewers will experience buffering.
videoInterlaceMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams have different interlacing. You need to configure the streams to have the same interlacing.
videoProfileMismatch
Reason:Bad secondary stream
Description:In the current configuration, the video's primary and backup streams have different profiles. You need to configure the streams to have the same profile.
videoResolutionSuboptimal
Reason:Check resolution
Description:Please check the video resolution. The current resolution is (%(actual_w)dx%(actual_h)d), which is not optimal.
videoResolutionUnsupported
Reason:Unsupported resolution
Description:You need to change the video resolution. The current resolution is (%(actual_w)dx%(actual_h)d), which is not supported for this configuration. The expected video resolution is (%(expected_w)dx%(expected_h)d).