全部产品
Search
文档中心

视频直播:实时监控

更新时间:Jun 24, 2026

实时监控服务提供直播全链路的实时数据,支持针对单条直播流及域名粒度进行精细化监控,帮助您快速识别直播质量波动及解析异常。

使用说明

  • 实时监控的时间粒度根据监控项不同为5秒到1分钟不等,与运营分析和用量查询的时间粒度统计规则不同,因此同时间段数据可能存在差异。直播的用量计费以用量查询的数据为准。

  • 实时监控根据监控项不同支持7天或30天内的数据查询,单次查询最长时间跨度均有限制。

数据查询

  1. 登录视频直播控制台

  2. 在左侧导航栏选择数据中心 > 数据监控 > 实时监控,进入实时监控页面。

  3. 查看实时监控详情。

流数据查询

监控单条直播流的质量,包括推流数据、播放数据、直播中心流质量数据、直播记录和回调记录。输入准确的流ID进行查询:

  • 原始流:输入StreamName

  • 转码流:输入 StreamName_转码模板ID

监控项

监控指标

监控规则

推流数据

单条流的推流流量、推流带宽、视频帧率、视频码率、音频帧率、音频码率、推流客户端IP。相同IP重新推流会以不同颜色曲线显示。

说明

推流数据统计的是直播流在边缘节点的质量数据。

单次查询最大时间跨度3小时,只能查询近30天内的数据。

播放数据

单条流的播放带宽、播放流量、在线人数(并发连接数)、新建连接数。其中,在线人数(并发连接数)即当前正在观看该直播流的用户数,统计覆盖手机端和电脑端。

暂不支持HLS协议新建连接数查询。HLS并发连接数按照默认格式的请求进行统计:

  • M3U8文件请求示例:http(s)://example.aliyundoc.com/Appname/ StreamName.m3u8

  • TS切片请求示例:http(s)://example.aliyundoc.com/Appname/ StreamName/153*******_137***.ts

特殊格式的请求需提交工单进行配置。

单次查询最大时间跨度24小时,只能查询近30天内的数据。

直播中心流质量数据

单条流在直播中心的质量数据,包括视频帧率、视频码率、音频帧率、音频码率。

单次查询最大时间跨度3小时,只能查询近30天内的数据。

直播记录

直播流的域名、AppName、StreamName、推流开始和结束时间以及转码模板。

单次查询最大时间跨度30天,只能查询近30天内的数据。

回调记录

单条流的推/断流、录制和异常事件回调信息,包括回调接收URL、回调触发时间、回调内容和请求状态等。

单次查询最大时间跨度20天,只能查询近20天内的最多1000条回调记录。

域名数据查询

监控项

监控指标

监控规则

播放数据

域名粒度的播放流量、播放带宽、播放状态码数量、播放状态码占比。

单次查询最大时间跨度24小时,只能查询近7天内的数据。

推流数据

域名粒度的推流流量、推流带宽、推流状态码数量、推流状态码占比。

单次查询最大时间跨度1小时,只能查询近7天内的数据。

常见问题

调用实时监控相关 API 查询不到数据或与控制台不一致怎么办?

请按以下场景排查:

  • 数据延迟:API 接口的监控数据通常有延迟。如果查询不到近期数据,建议先查询昨天或最近 31 天内的历史数据进行验证,确认接口可正常返回数据。

  • 时间格式错误:DescribeLiveStreamPushMetricDetailData 等接口的开始时间和结束时间参数必须使用 UTC 格式(例如2026-05-17T16:00:00Z),而控制台默认展示的通常是本地时区时间,需进行转换。时间格式错误会导致查不到数据或查询结果与控制台不一致。