Media Services Live Event error codes

  • Article

Media Services logo v3

Warning

Azure Media Services will be retired June 30th, 2024. For more information, see the AMS Retirement Guide.

The following tables list the Live Event error codes.

LiveEventConnectionRejected

When you subscribe to the Event Grid events for a live event, you may see one of the following errors from the LiveEventConnectionRejected event.

Error Information
MPE_RTMP_APPID_AUTH_FAILURE
Description Incorrect ingest URL
Suggested solution APPID is a GUID token in RTMP ingest URL. Make sure it matches with Ingest URL from API.
MPE_INGEST_ENCODER_CONNECTION_DENIED
Description Encoder IP isn't present in the configured IP allow list
Suggested solution Make sure the encoder's IP is in the IP Allow List. Use an online tool such as whoismyip or CIDR calculator to set the proper value. Make sure the encoder can reach the server before the actual live event.
MPE_INGEST_RTMP_SETDATAFRAME_NOT_RECEIVED
Description The RTMP encoder did not send the setDataFrame command.
Suggested solution Most commercial encoders send stream metadata. For an encoder that pushes a single bitrate ingest, this may not be issue. The LiveEvent is able to calculate incoming bitrate when the stream metadata is missing. For multi-bitrate ingest for a PassThru channel or double push scenario, you can try to append the query string with 'videodatarate' and 'audiodatarate' in the ingest URL. The approximate value may work. The unit is in Kbit. For example, rtmp://hostname:1935/live/GUID_APPID/streamname?videodatarate=5000&audiodatarate=192
MPE_INGEST_CODEC_NOT_SUPPORTED
Description The codec specified isn't supported.
Suggested solution The LiveEvent received unsupported codec. For example, an RTMP ingest, LiveEvent received non-AVC video codec. Check encoder preset.
MPE_INGEST_DESCRIPTION_INFO_NOT_RECEIVED
Description The media description information was not received before the actual media data was delivered.
Suggested solution The LiveEvent does not receive the stream description (header or FLV tag) from the encoder. This is a protocol violation. Contact encoder vendor.
MPE_INGEST_MEDIA_QUALITIES_EXCEEDED
Description The count of quality levels for audio or video type exceeded the maximum allowed limit. Quality levels beyond the limit were ignored by the service.
Suggested solution When Live Event mode is Live Encoding, the encoder should push a single bitrate of video and audio. Note that a redundant push from the same bitrate is allowed. Check the encoder preset or output settings to make sure it outputs a single bitrate stream.
MPE_INGEST_BITRATE_AGGREGATED_EXCEEDED
Description The total incoming bitrate in a live event or channel service exceeded the maximum allowed limit.
Suggested solution The encoder exceeded the maximum incoming bitrate. This limit aggregates all incoming data from the contributing encoder. Check encoder preset or output settings to reduce bitrate.
MPE_RTMP_FLV_TAG_TIMESTAMP_INVALID
Description The timestamp for video or audio FLVTag is invalid from the RTMP encoder.
Suggested solution Deprecated.
MPE_INGEST_FRAMERATE_EXCEEDED
Description The incoming encoder ingested streams with frame rates exceeded the maximum allowed 30 fps for encoding live events/channels.
Suggested solution Check encoder preset to lower frame rate to under 36 fps.
MPE_INGEST_VIDEO_RESOLUTION_NOT_SUPPORTED
Description The incoming encoder ingested streams exceeded the following allowed resolutions: 1920x1088 for encoding live events/channels and 4096 x 2160 for basic and standard pass-through live events/channels.
Suggested solution Check encoder preset to lower video resolution so it doesn't exceed the limit.
MPE_INGEST_RTMP_TOO_LARGE_UNPROCESSED_FLV
Description The live event has received a large amount of audio data at once, or a large amount of video data without any key frames. We have disconnected the encoder to give it a chance to retry with correct data.
Suggested solution Ensure that the encoder sends a key frame for every key frame interval(GOP). Enable settings like "Constant bitrate(CBR)" or "Align Key Frames". Sometimes, resetting the contributing encoder may help. If it doesn't help, contact encoder vendor.

LiveEventEncoderDisconnected

You may see one of the following errors from the LiveEventEncoderDisconnected event.

Error Information
MPE_RTMP_SESSION_IDLE_TIMEOUT
Description RTMP session timed out after being idle for allowed time limit.
Suggested solution This typically happens when an encoder stops receiving the input feed so that the session becomes idle because there is no data to push out. Check if the encoder or input feed status is in a healthy state.
MPE_RTMP_FLV_TAG_TIMESTAMP_INVALID
Description The timestamp for the video or audio FLVTag is invalid from RTMP encoder.
Suggested solution Deprecated.
MPE_CAPACITY_LIMIT_REACHED
Description Encoder sending data too fast.
Suggested solution This happens when the encoder bursts out a large set of fragments in a brief period. This can theoretically happen when the encoder can't push data for while due to a network issue and the bursts out data when the network is available. Find the reason from encoder log or system log.
Unknown error codes
Description These error codes can range from memory error to duplicate entries in hash map. This can happen when the encoder sends out a large set of fragments in a brief period. This can also happen when the encoder couldn't push data for while due to a network issue and then sends all the delayed fragments at once when the network becomes available.
Suggested solution Check the encoder logs.

Other error codes

Error Information Rejected/Disconnected Event
ERROR_END_OF_MEDIA Yes
Description This is general error.
Suggested solution None.
MPI_SYSTEM_MAINTENANCE Yes
Description The encoder disconnected due to service update or system maintenance.
Suggested solution Make sure the encoder enables 'auto connect'. It allows the encoder to reconnect to the redundant live event endpoint that is not in maintenance.
MPE_BAD_URL_SYNTAX Yes
Description The ingest URL is incorrectly formatted.
Suggested solution Make sure the ingest URL is correctly formatted. For RTMP, it should be rtmp[s]://hostname:port/live/GUID_APPID/streamname
MPE_CLIENT_TERMINATED_SESSION Yes
Description The encoder disconnected the session.
Suggested solution This is not error. The encoder initiated disconnection, including graceful disconnection. If this is an unexpected disconnect, check the encoder logs.
MPE_INGEST_DISCONTINUITY No
Description There is discontinuty in incoming data.
Suggested solution This is a warning that the encoder drops data due to a network issue or a system resource issue. Check the encoder log or system log. Monitor the system resource (CPU, memory or network) as well. If the system CPU is too high, try to lower the bitrate or use the H/W encoder option from the system graphics card.

Get help and support

You can contact Media Services with questions or follow our updates by one of the following methods: