All Products
Search

This Product

    ApsaraVideo Live:Live monitoring

    Document Center

    ApsaraVideo Live:Live monitoring

    Last Updated:Aug 06, 2025

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

    Introduction

    ApsaraVideo Live provides a live monitoring feature that you can use to monitor the performance and quality of online live events in real time. The system triggers alerts for exceptions, such as frame rate and bitrate fluctuations, audio and video synchronization issues, high latency, and stuttering, to ensure the reliability of various professional live events.

    Core features

    • Supports monitoring in 4-split, 8-split, and 12-split screen modes.

    • Provides a real-time dashboard to display data such as the frame rate and bitrate of live streams.

    • Supports real-time alerts for exceptions such as abnormal frame rates, abnormal bitrates, audio and video synchronization issues, stuttering, and high latency.

    Scenarios

    • Video platforms: Provides monitoring for various live streams hosted on the platform, especially for major live events and important sessions.

    • Enterprise services: Supports concurrent monitoring of multiple sessions to ensure the reliability of live streams for enterprise customers.

    • Organization services: Supports concurrent monitoring of multiple sessions to ensure the reliability of daily live streams for the organization's streamers.

    Usage notes

    • Live monitoring is a paid feature. For more information about billing, see Billing of live monitoring.

    • For information about the live centers that support live monitoring, see Service regions. By default, you can create a maximum of 20 concurrent monitoring sessions in each region.

    Prerequisites

    To play monitored streams in the live monitoring console, you must configure an HTTPS certificate and Cross-Origin Resource Sharing (CORS) for the stream pulling domain name used for the monitored output.

    • CORS configuration: Configure the Access-Control-Allow-Origin HTTP header and set its value to https://live.console.alibabacloud.com. For more information, see Configure HTTP headers.

    • HTTPS configuration: Configure a valid HTTPS certificate. For more information, see Configure HTTPS secure acceleration.

    Procedure

    1. Log on to the ApsaraVideo Live console.

    2. In the left navigation pane, select Live Monitoring.

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

      Parameter

      Description

      Output configuration

      Session Name

      Enter a name for the session.

      Output Resolution

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

      Live Center

      The live center that you have selected.

      Monitored stream output domain name

      Select a domain name for the combined stream output from the drop-down list. If no suitable domain name is available, click Add. For more information, see Add an accelerated domain name.

      Monitored stream configuration

      Monitored stream

      You can manually add streams, select streams from the ApsaraVideo Live console, or upload streams in batches. You can add up to 12 streams.

      • Manual Add: Click Manual Add, enter the stream name and stream address. You can also sort and delete the streams.

      • Select from Console: Click Select From Console, select the domain name from the drop-down list, and then select the online live streams.

      • Batch Upload: Upload live streams in batches.

      Monitoring notification configuration

      Notification method

      • Monitoring Callback: Enter a webhook address in the HTTP or HTTPS format.

      • DingTalk Monitoring Alert: Alert information is sent by a DingTalk chatbot. You must first set up a DingTalk chatbot and enter its webhook address in HTTP or HTTPS format here. For more information, see Custom Robot Access.

        Important

        Set the custom keyword of the DingTalk chatbot to "Alert". Otherwise, messages cannot be received.

      Advanced Configuration

      • Video frame rate alert threshold: An alert is triggered if the video frame rate of the monitored stream is less than (Alert threshold for frame rate × Original frame rate of the stream). The threshold is a coefficient. Valid values: (0.0, 1.0].

      • Audio/video bitrate alert threshold: An alert is triggered if the audio/video bitrate of the monitored stream is greater than (Alert threshold for bitrate × Original bitrate of the stream). The threshold is a coefficient. Valid values: (0.0, 100].

      • Interruption duration alert threshold: An alert is triggered if the duration of the stream interruption exceeds this threshold. The threshold is the interruption duration. Valid values: (0, 65535]. Unit: seconds.

    4. Click OK to complete the session configuration.

    5. Start monitoring.

      After the session is configured, find the session and click Start Monitoring in the Actions column. Click Preview to view the monitoring page.

      Important

      Billing continues for services in the Monitoring status. Closing the monitoring page does not stop billing. To stop monitoring, you must click Stop Monitoring in the Actions column.

      11

    6. The following figure shows the monitoring preview area.

      监播

      Ordinal number

      Description

      ①

      Stream UNIX timestamp. Displayed in the upper-left corner.

      ②

      Audio volume. Distinguishes between left and right sound channels. The volume is calculated based on the Peak standard. Displayed in the lower-left corner.

      ③

      Real-time frame rate and bitrate. Displayed in the upper-right corner.

      ④

      Alert details. Displayed in the lower-right corner.

      Supported alarm metrics:

      • vfps: alert for video frame rate exception.

      • afps: alert for audio frame rate exception.

      • br: alert for bitrate exception.

      • eof: alert for stream interruption.

      • a-v: alert for audio and video out of sync.

      • wc (warning count): the total number of alerts.

      ⑤

      Audio quality detection. Displayed in the lower-left corner.

      Supported audio quality detection types:

      • poor: abnormal audio quality.

      • normal: normal audio quality.

      • good: good audio quality.

    API operations

    You can call the following API operations to quickly integrate and use the live monitoring service.

    1. Call the CreateLiveStreamMonitor operation to create a monitoring session.

    2. Call the StartLiveStreamMonitor operation to start monitoring.

    3. Call the StopLiveStreamMonitor operation to stop monitoring.

    4. Call the DeleteLiveStreamMonitor operation to delete a monitoring session.

    Consultation

    If you have any questions or suggestions while using the live monitoring system, search for the DingTalk group ID 35080444 to join our DingTalk group.