All Products
Search
Document Center

ApsaraVideo Live:Live monitoring

Last Updated:May 15, 2025

This topic describes the features and scenarios of the live monitoring system and how to manage monitoring sessions in the ApsaraVideo Live console.

Overview

You can use the live monitoring feature of ApsaraVideo Live to monitor the quality of live events in real time. The system automatically triggers alerts for issues such as fluctuations in frame rate and bitrate, asynchronous audio and video, high latency, and playback stuttering.

Key features

  • The live monitoring system allows you to monitor 4, 8, or 12 live streams in split screens at the same time.

  • The information about a live stream such as the frame rate and bitrate is displayed in real time.

  • Real-time alerts are triggered when exceptions occur, such as frame rate exceptions, bitrate exceptions, audio and video synchronization issues, stuttering, and high latency.

Scenarios

  • Video platforms: The live monitoring system provides monitoring for different types of live events, especially major live events and sessions.

  • Enterprise services: You can monitor multiple live sessions at the same time to ensure the continuity of live events for enterprise customers.

  • Organization services: You can monitor multiple live sessions at the same time to ensure the continuity of daily live events for streamers.

Usage notes

  • Live monitoring is a paid feature. For billing details, see Billing of live monitoring.

  • Live monitoring is available only in specific regions. For more information, see Supported regions. By default, you can create up to 20 monitoring sessions in a region.

Prerequisites

Make sure that you configure cross-origin resource sharing (CORS) and an HTTPS certificate for the streaming domain of the monitored streams.

Console procedure

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Scenario-based Services - Live Monitoring.

  3. On the Live Monitoring page, select a region and click Add Session.

    Parameter

    Description

    Output Configurations

    Session Name

    Enter a session name.

    Output Resolution

    Select an output resolution from the drop-down list. Multiple resolutions for landscape and portrait orientations are supported.

    Live Center

    Select the live center in the region that you selected.

    Source Domain Name

    Select a domain name from the drop-down list. The domain name is used to play the monitored streams. If no domain names are available, click Add below the drop-down list to add a domain name. For more information, see Add an accelerated domain name.

    Stream Configurations

    Stream for Monitoring

    You can add streams manually, select streams under a domain, or batch upload streams. You can add up to 12 streams.

    • Click Add Manually. Enter a stream name in the Stream Name field and a URL in the Stream URL field. You can sort and delete the streams that you add.

    • Click Select from ApsaraVideo Live Console. Select a domain name from the Domain Name drop-down list and then select the live streams that you want to monitor.

    • Click Batch Upload to upload multiple streams at the same time.

    Notification Configurations

    Notification Method

    • Monitoring Callbacks: Enter a callback URL in the HTTP or HTTPS format.

    • DingTalk Alerts: Enter the URL of a DingTalk chatbot in the HTTP or HTTPS format. You must specify a DingTalk chatbot that you configured to send you live monitoring alerts. For more information, see Configure a custom chatbot.

      Important

      Specify "Alert" as the custom keyword of the DingTalk chatbot. Otherwise, you cannot receive messages from the chatbot.

    Advanced Settings

    • Video Frame Rate Alert Threshold: An alert is triggered when the video frame rate of the monitored stream falls below the product of the threshold and the original frame rate. This parameter is a scale factor. Valid values: (0.0,1.0].

    • Audio/Video Bitrate Alert Threshold: An alert is triggered when the audio/video bitrate of the monitored stream is greater than the product of the threshold and the original bitrate. This parameter is a scale factor. Valid values: (0.0,100].

    • Interruption Duration Alert Threshold: An alert is triggered when the monitored stream is interrupted for a period of time that is longer than the threshold. Valid values: integers within the range of (0,65535].

  4. Click OK. The Monitoring Session page appears.

  5. Start monitoring.

    On the Monitoring Session page, find the session that you added and click Start Monitoring in the Actions column. After monitoring starts, you can click Preview to go to the monitoring page.

    Important

    After you close the monitoring page, the Monitoring Status column still displays Monitoring and billing continues. To stop monitoring and avoid unnecessary fees, click Stop Monitoring in the Actions column.

    11

  6. Explore the monitoring preview area.

    监播

    No.

    Description

    The timestamp of the live stream. The timestamp is displayed in the upper-left corner of each split screen.

    The audio volumes, including the volume for the left sound channel and the volume for the right sound channel. The volumes are adjusted by using peak normalization. The volumes are displayed in the lower-left corner of each split screen.

    The real-time frame rate and bitrate that are displayed in the upper-right corner of each split screen.

    The alert information that is displayed in the lower-right corner of each split screen.

    Supported alert types:

    • vfps: an alert that indicates video frame rate exception.

    • afps: an alert that indicates audio frame rate exception.

    • br: an alert that indicates bitrate exception.

    • eof: an alert that indicates traffic interruption.

    • a-v: an alert that indicates audio and video out of sync.

    • wc: the total number of alerts.

    The audio quality that is displayed in the lower-left corner of each split screen.

    Supported values for audio quality:

    • poor: poor audio quality.

    • normal: normal audio quality.

    • good: good audio quality.

API references

You can call the following API operations to access and use live monitoring:

  1. Call CreateLiveStreamMonitor to create a monitoring session.

  2. Call StartLiveStreamMonitor to start live monitoring.

  3. Call StopLiveStreamMonitor to stop live monitoring.

  4. Call DeleteLiveStreamMonitor to delete a monitoring session.

Consultation

If you encounter any problems or have any suggestions when using live monitoring, join the DingTalk group 35080444 and feel free to contact us in the group.