You need to enable JavaScript to run this app.
视频直播

视频直播

Copy page
Download PDF
数据中心
流数据查询
Copy page
Download PDF
流数据查询

本文档介绍如何使用视频直播控制台查询推流数据、拉流数据、回源数据及回调记录。您可以通过图表和记录信息快速定位异常、还原直播行为,并辅助进行质量监控和数据分析。

支持的数据类型

数据类型

查询内容

推流数据

帧率、码率、时间戳、最大音视频帧间隔

推流记录

开始时间、结束时间、推流时长、客户端 IP、断流原因

回源数据

视频/音频码率、帧率、时间戳、最大音视频帧间隔

拉流数据

带宽、流量、在线人数

回调记录

推流开始、推流结束、录制、截图等回调的调用记录和详情

背景信息

  • 支持查询最近 31 天的推流统计数据和最近 7 天的拉流统计数据,单次查询的时间跨度不超过 24 小时。
  • 支持查询删除域名的推流数据和拉流数据。

前提条件

  • 查询推流数据:需已完成推流配置,且在指定时间范围内产生推流行为;
  • 查询拉流数据:需已完成推流,并在指定时间范围内产生实际拉流;
  • 查询回调记录:需已配置回调地址,且在配置生效后产生了对应事件(如推流、录制、截图等);
  • 已准备域名、AppName、StreamName 等查询参数。

操作步骤

查询推流数据

  1. 登录视频直播控制台
  2. 在左侧导航栏选择数据中心>流数据查询>推流数据,进入推流数据查询页面。
  3. 支持自定义查询条件,查询条件包含域名、AppName、StreamName、时间粒度和时间范围。
  4. 单击查询,查询指定流的视频码率、音频码率、视频帧率、音频帧率(即音频采样率,单位为 kHz)、时间戳和最大音视频帧间隔。
  5. 在折线图上移动光标,可查看某时间点的具体数据。
    Image

查询推流记录

  1. 登录视频直播控制台

  2. 在左侧导航栏选择数据中心>流数据查询>推流数据,进入推流数据查询页面。

  3. 单击推流记录页签。

  4. 支持自定义查询条件,查询条件包含推流域名、AppName、StreamName、时间粒度和时间范围。

  5. 单击查询,开始查询指定流的推流记录,推流记录中包含推流开始时间、结束时间、推流客户端 IP 和断流原因等信息。

  6. 单击操作列的查看数据按钮,可进入推流数据页签查看该条推流记录的推流数据。
    Image
    常见的断流原因如下所示,如您获取的断流原因不在下表或您无法判断处理方法,请创建工单联系技术支持进行处理。

    断流原因

    说明

    FLV 协议解析失败

    FLV 协议解析失败导致推流断开。

    RTMP 协议不兼容

    RTMP 协议不兼容导致推流断开。

    TLS 协议失败

    TLS 协议失败导致推流断开。

    长时间没有收到数据断开

    推流端长时间没有数据传输导致超时断开。

    对端主动断开链接

    推流端非通过正常停止直播操作导致的推流断开,如网络中断、直接关闭推流软件等。

    读取数据超时

    视频直播中心数据 I/O 错误导致的推流断开。

    高优先级流替换低优流

    被高优先级流推流导致的低优先级流推流断开。

    鉴权参数无效

    URL 鉴权参数字段无效、鉴权超时等原因导致推流断开。

    禁播流禁止推流

    直播流被禁用导致的推流断开。

    控制台断开直播

    调用 KillStream 接口流断开直播。

    内部错误

    视频直播中心内部错误,请联系技术支持。

    远程鉴权失败

    远程鉴权失败导致推流断开。

    推流断开

    复杂原因导致的推流断开,请联系技术支持。

    推流正常结束

    推流端通过停止直播功能正常结束推流。

    网络异常断开

    网络异常导致推流断开。

    相同流 ID 重复推流

    使用相同流名称进行推流导致推流断开。

查询回源数据

  1. 登录视频直播控制台
  2. 在左侧导航栏选择数据中心>流数据查询>回源数据,进入回源数据查询页面。
  3. 支持自定义查询条件,查询条件包含域名、AppName、StreamName、时间粒度和时间范围。
  4. 单击查询,开始查询指定流的视频码率、音频码率、视频帧率、音频帧率(即音频采样率,单位为 kHz)、时间戳和最大音视频帧间隔。
  5. 在折线图上移动光标,可查看某时间点的具体数据。
    Image

查询拉流数据

  1. 登录视频直播控制台
  2. 在左侧导航栏选择数据中心>流数据查询>拉流数据,进入拉流数据查询页面。
  3. 流地址搜索输入框内输入包含 domain/app/stream 的流地址。
  4. 支持自定义筛选条件,筛选条件包含时间粒度、时间范围、协议、区域和运营商。
  5. 单击查询,选择带宽数据/流量数据/在线人数,开始查询指定流带宽、流量和在线人数。

带宽数据

  • 在折线图上移动光标,可查看某时间点的带宽数据。
  • 支持折线图、柱状图和列表 3 种展示方式。
  • 支持下载查询结果到本地。
  • 带宽数据按 1000 进制换算,即 1 Gbps = 1000 Mbps。

Image

流量数据

  • 在折线图上移动光标,可查看某时间点的流量数据。
  • 支持折线图、柱状图和列表 3 种展示方式。
  • 支持下载查询结果到本地。
  • 流量数据按 1000 进制换算,即 1 GB = 1000 MB。

Image

在线人数

  • 在折线图上移动光标,可查看某时间点的在线人数;
  • 支持折线图、柱状图和列表 3 种展示方式;
  • 支持下载查询结果到本地。

Image

回调记录

回调记录页面用于展示直播过程中各类回调事件的触发情况,包括推流开始、推流结束、录制回调、截图回调等。便于用户排查回调未触发、调用失败等问题。

1. 设置回调记录查询条件

  1. 登录视频直播控制台
  2. 在左侧导航栏选择数据中心>流数据查询>回调记录,进入回调记录查询页面。
  3. 在页面顶部设置查询条件,支持按 DomainAppNameStreamName回调类型回调状态时间筛选。

2. 查看查询结果

  1. 单击查询,开始查询指定条件下的回调记录。
  2. 查询结果包含 Stream Name、App Name、域名、回调时间、回调地址和回调内容。

3. 查看回调详情

  1. 在查询结果中,单击回调内容列的查看按钮,打开回调详情弹窗。

  2. 在弹窗中查看该条回调的详细信息。用于分析异常回调、定位接入问题,推荐配合回调状态筛选使用。

    字段名称

    说明

    回调状态

    显示当前回调是否成功,如失败将以红色标签标记,便于快速识别异常。

    失败原因

    当回调失败时,展示服务端返回的错误原因,用于帮助排查问题。

    回调触发时间

    回调任务被触发的时间。

    回调内容

    实际发送至用户回调地址的请求体内容。

    相应时间

    回调地址返回响应的时间。

    响应内容

    回调地址返回的响应内容,用于确认接收方是否正确处理了回调请求。

Last updated: 2026.06.02 19:38:11