Documentation
Home Page ApsaraVideo Live Live + Live Monitoring

Live Monitoring

Updated at:
Copy as MD
Product

Live Monitoring provides real-time stream quality assurance for professional live events through multi-view dashboards and intelligent alerts.

Introduction

Live Monitoring delivers real-time quality assurance for professional live events. Visual dashboards and proactive alerts help you detect and resolve stream issues quickly.

Core features

  • Multi-view monitoring: Monitor up to 12 live streams on a single screen with 4-split, 8-split, and 12-split layouts.

  • Real-time data dashboard: Overlay key metrics (frame rate, bitrate, audio volume) on each monitoring view for real-time insight.

  • Intelligent alerts: Triggers alerts immediately when a stream shows abnormal frame rate, bitrate, audio/video desync, stuttering, latency, or interruption.

Use cases

  • Video platforms: Professional monitoring for major events and competitions to ensure broadcast quality.

  • Enterprise services: Concurrent monitoring of multiple sessions for enterprise events such as product launches and webinars.

  • Agency services: MCNs or streaming platforms can monitor multiple streamers concurrently for stable daily broadcasts.

Notes

  • Live Monitoring is a paid feature (Live Monitoring fees).

  • Live Monitoring is available only in specific live centers (Supported regions). By default, you can create up to 20 monitoring sessions per region.

Prerequisites

To play monitored streams, configure HTTPS and CORS for the output streaming domain.

Procedure

  1. Log on to the ApsaraVideo Live console.

  2. In the left-side navigation pane, choose Live + > Live Monitoring.

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

    Parameter

    Description

    Output configurations

    Session name

    Enter a name for the monitoring session.

    Output resolution

    Select an output resolution. Landscape and portrait orientations are supported.

    Live center

    The selected live center.

    Output domain name

    Select the output stream domain. If no domain is available, click Add to add one (Add an accelerated domain name).

    Stream configurations

    Stream for monitoring

    Add up to 12 streams manually or from the ApsaraVideo Live console.

    • Add Manually: Click Add Manually, then enter a stream name and URL. You can sort and delete added streams.

    • Select from ApsaraVideo Live Console: Click Select from ApsaraVideo Live Console, choose a domain name, and select the online streams to monitor.

    • Batch Upload: Upload multiple streams at once.

    Notification configurations

    Notification method

    • Monitoring callbacks: Enter a callback URL (HTTP or HTTPS). Callback parameters.

    • DingTalk alerts: Receive alerts through a DingTalk group chatbot. Set up a chatbot and enter its webhook URL (HTTP or HTTPS). Custom robot access.

      Important

      Set the DingTalk chatbot keyword to "Alert". Otherwise, messages will not be delivered.

    Advanced settings

    • Video frame rate alert threshold: Alerts when the video frame rate falls below (Threshold × Original Frame Rate). Range: (0.0, 1.0].

    • Audio/video bitrate alert threshold: Alerts when the audio or video bitrate exceeds (Threshold × Original Bitrate). Range: (0.0, 100].

    • Interruption duration alert threshold: Alerts when a stream interruption exceeds this duration (seconds). Range: (0, 65535].

  4. Click OK to save the session configuration.

  5. Start monitoring.

    Find the session in the list and click Start Monitoring in the Actions column. Click Preview to open the monitoring page.

    Important

    Billing continues while the session status is Monitoring. Closing the monitoring page does not stop billing. Click Stop Monitoring in the Actions column to stop.

    11

  6. The monitoring preview displays:

    Live monitoring preview

    Number

    Description

    ①

    Stream timestamp (upper-left).

    ②

    Audio volume (lower-left). Shows left/right channel levels based on the Peak standard.

    ③

    Real-time frame rate and bitrate (upper-right).

    ④

    Alert information (lower-right).

    Supported alert types:

    • vfps: video frame rate alert.

    • afps: audio frame rate alert.

    • br: bitrate anomaly alert.

    • eof: stream interruption alert.

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

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

    ⑤

    Audio quality (lower-left).

    Supported audio quality types:

    • poor: poor audio quality.

    • normal: normal audio quality.

    • good: good audio quality.

API reference

To integrate Live Monitoring, call the API operations in the following order:

  1. Create a monitoring session.

  2. Start monitoring.

  3. Stop monitoring.

  4. Delete a monitoring session.

Monitoring alerts

Alert events are sent to your callback URL as HTTP POST requests with Content-Type set to application/json.

Callback parameters

Parameter

Type

Description

monitorId

String

The unique ID of the monitoring session.

monitorName

String

The name of the monitoring session.

streamName

String

The name of the stream that triggered the alert.

streamUrl

String

The URL of the stream that triggered the alert.

event

String

The alert type:

  • vfps: video frame rate alert.

  • afps: audio frame rate alert.

  • br: bitrate anomaly alert.

  • eof: stream interruption alert.

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

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

time

Long

The timestamp when the alert occurred.

detail

String

Detailed information about the alert.

Callback example

{
    "monitorId": "3da2464f-2dea********-8b9d34b43430",
    "monitorName": "AI",
    "streamName": "cn",
    "streamUrl": "https://web******pull.aliyun.com/webinar/202****HU57.m3u8",
    "event": "a-v",
    "time": 1764147542481071,
    "detail": "a-v=0287"
}

Feedback and support

For questions or suggestions about Live Monitoring, join our DingTalk group (ID: 35080444).

Previous：FAQNext：Features