SDK 数据查询
最近更新时间：2024.01.22 16:14:58
首次发布时间：2023.05.11 17:37:00
本文介绍如何查看视频直播产品的推拉流指标数据，以帮助您监控直播内容在不同平台上的质量表现。
操作步骤
登录视频直播控制台。
选择左侧导航的数据中心 > SDK 数据查询，默认进入 SDK 数据查询的推流全局数据页签。
切换页签，您可以查看指定时间范围内推流全局数据、推流单路数据、拉流全局数据、拉流单路数据的 SDK 指标折线图。
在 SDK 数据查询页面，您可以使用以下查询功能更精细化的筛选查询结果。
- 分端查看：支持查看移动端的推流数据、支持查看移动端和 Web 端的拉流数据；
- 指定应用：支持查看指定应用或全部应用的 SDK 指标数据，默认为全部应用；
- 数据拆维：支持最大指定 3 个维度对展示数据进行拆分，默认不进行数据拆分；
- 指定时间：支持快速选择查询时间，或手动指定时间区间；
- 数据聚合：支持快速选择数据聚合的时间粒度；
- 指定指标：支持查看指定指标或全部指标的数据；
- 条件过滤：支持根据过滤项（等于或不等于字段值）对数据进行过滤。
说明
当 SDK 版本过低时，可能会出现某项数据丢失的问题，导致数据看板中出现异常值。如遇到该情况，可尝试更新 SDK 版本。
指标说明
SDK 日志上报时机
- 我们将设置 URL 并首次调用 play 方法视为一次播放。在这个过程中，每次播放仅记录并上报一条埋点日志。
- 起播阶段用户停止播放（调用 stop ）和播放阶段用户停止播放（调用 stop ）均上报播放成功日志。
关键质量指标
| 流类型 | 指标 | 说明 |
|---|---|---|
| 推流 | 推流码率 | 以数据聚合时间粒度展示所有推流（或单路推流）的码率平均值趋势图，以及在查询时间内的码率平均值。 |
| 推流平均帧率 | 以数据聚合时间粒度展示所有推流（或单路推流）的帧率平均值趋势图，以及在查询时间内的帧率平均值。 | |
拉流 | 拉流成功率 | 指在视频直播过程中，观众端（即观众的设备）成功接收和播放直播流的比例。可衡量直播流能够被观众正常拉取的概率。 |
首帧时间 | 指在视频直播过程中，从用户点击观看直播或播放按钮开始，到第一帧视频内容显示在屏幕上所经过的时间。可衡量观众在开始观看视频直播时所需等待的时长。 | |
视频渲染百秒卡顿时长 | 指在视频直播过程中，每 100s 的播放时间内，视频渲染卡顿的时长。可衡量观众在观看视频过程中卡顿的严重程度。 说明 视频渲染卡顿判断标准：当渲染的视频帧与上一次渲染的视频帧之间的间隔大于 200ms 时，将其记入视频渲染卡顿时长。通过持续监测和优化该指标，可以提升视频播放的流畅性和用户体验。 | |
拉流码率 | 以数据聚合时间粒度展示所有拉流（或单路拉流）的码率平均值趋势图，以及在查询时间范围内的码率平均值。 说明 为了减少起播时码率波动的影响，拉流码率的统计范围为开始播放 5 秒后的数据。 | |
| 平均播放时长 | 以数据聚合时间粒度展示所有拉流（或单路拉流）的播放平均时长趋势图，以及在查询时间范围内的播放时长平均值。 |