水晶球的数据洞察功能提供通话用量和质量数据的阶段性分析,帮助你了解用量和质量的总体趋势、不同维度的分布情况和每天的数据明细。

  • 支持查看指定日期范围内的每日数据。
  • 数据每日更新。
  • 你也可以通过水晶球 RESTful API 获取相关数据,具体可咨询商务。
当前仅提供 Agora RTC SDK 的用量和质量数据。

使用步骤

  1. 联系 sales@agora.io 为你的项目开通数据洞察功能。
  2. 登录控制台,点击左侧菜单栏中的水晶球
  3. 在页面左上方的下拉菜单中选择你要查看的项目。
  4. 点击数据洞察下的用量概览查看用量数据或质量概览查看质量数据。
  5. 在页面左上角指定需要查看数据的时间范围(UTC 时间),点击左上角的设置按钮选择页面展示的数据(默认全部显示)。
数据洞察提供的通话数据有以下限制:
  • 提供 2019 年 8 月 1 日 起的数据。
  • 一次最多可以查看 30 天的数据。
  • 最多支持查看三个月内的数据。你可以在数据图表的右上角点击更多保存历史数据。
  • 数据洞察会在每天上午 8 点(UTC 时间)完成前一天的数据统计,因此在该时间之前可能无法查询到前一天的数据。如果你需要更实时地查看数据,可以使用实时数据
  • 用量概览

    你可以在用量概览页面查看以下数据:

    • 总览:查看通话时长、频道数、最大同时在线人数、通话人数等用量数据的趋势变化,定位异常日期。
    • 分布:从不同维度查看 Top 用量(前五/前十)的数据,掌握用户主要所在的国家、所使用的操作系统和 SDK 版本。

    总览

    总览面板分两组卡片以图表形式显示每天的用量数据。

    卡片左侧显示用量指标的累计或日均值,右侧以曲线图展示每天的数据,指标异常的日期会以红点标记。点击曲线图右上角的更多以表格形式查看每天的数据,或者下载数据到本地查看。

    时长

    指标名称 指标说明
    通话时长 所有用户的实时音视频总时长(分钟)
    视频通话时长 所有用户的实时视频总时长(分钟)
    音频通话时长 所有用户的实时音频总时长(分钟)

    频道和用户

    指标名称 指标说明
    通话频道数 从第一个用户加入频道到最后一个用户离开频道,计为一个通话频道。
    大频道数 最高同时在线人数大于等于 100 人的频道数。
    最大同时在线频道数 同时进行中频道的峰值。
    最大同时在线人数 同时在线人数的峰值(用户可在不同频道中)。
    通话人数 每日按用户名和频道名去重。同一真实用户以不同的用户名加入不同频道会被计为多个用户。
    通话进出人次 用户加入频道的次数。

    分布

    分布面板展示以下维度的排名前五或前十的用量数据。

    维度 描述
    全球-国家 用量最高的十个国家。
    中国-省直辖市自治区 用量最高的十个省/直辖市/自治区。
    网络类型 用量最高的五个网络类型。
    操作系统 用量最高的五个操作系统。
    频道同时在线人数 将频道按照在线人数峰值分类,用量最高的五类频道。
    SDK 版本 用量最高的十个 SDK 版本。
    如果某一条目没有用量,则不会在面板上显示。

    质量概览

    你可以在质量概览页面查看以下数据:

    • 总览:查看加入频道时间、首次出图出声时间、用户体验和网络等质量指标的趋势变化,识别出异常日期。
    • 分布:从不同维度查看 Top 用量(前五/前十)的质量数据,掌握用户主要所在国家、所使用的操作系统和 SDK 版本的质量情况。

    总览

    总览面板分几组卡片以图表形式显示每天的质量数据。

    卡片左侧显示质量指标的均值(每日数据总和/天数),右侧以曲线图展示每天的数据(虚线为均值),指标异常的日期会以红点标记。点击曲线图右上角的更多以表格形式查看每天的数据,或者下载数据到本地查看。

    加入频道

    指标名称 指标说明
    加入频道成功率 加入频道成功人数 / 尝试加入频道人数
    5 秒加入频道成功率 5 秒内加入频道成功人数 / 尝试加入频道人数

    首次加载

    指标名称 指标说明
    音频首次出声时间 从用户尝试加入频道到听到声音的时间,按当天所有用户的数值排序取中位数(若加入频道时,频道内无音频流,则不纳入计算)
    视频首次出图时间 从用户尝试加入频道到看到画面的时间,按当天所有用户的数值排序取中位数(若加入频道时,频道内无视频流,则不纳入计算)

    用户体验

    指标名称 指标说明
    音频卡顿率 音频发生卡顿的时长 / 总音频时长。
    音频卡顿达到 200 ms,即被计入卡顿时长。
    视频卡顿率 视频发生卡顿的时长 / 总视频时长。
    视频卡顿达到 600 ms,即被计入卡顿时长。

    网络延时

    指标名称 指标说明
    网络延时 发送端到接收端的网络延时,单位为毫秒,取当天所有用户网络延迟的中位数。

    网络传输

    指标名称 指标说明
    音频优质传输率 音频传输过程中,丢包率小于等于 5% 的传输比例。
    视频优质传输率 视频传输过程中,丢包率小于等于 5% 的传输比例。

    分布

    分布面板展示以下维度的用量前五或前十的质量数据。

    维度 描述
    国家 用量最高的五个国家。
    网络类型 用量最高的五个网络类型。
    操作系统 用量最高的五个操作系统。
    频道同时在线人数 将频道以在线人数峰值分类,用量最高的五类频道。
    SDK 版本 用量最高的十个 SDK 版本。
    如果某一条目没有用量,则不会在面板上显示。

    重要概念

    本节介绍数据洞察涉及的重要概念,点击了解更多 Agora 的关键概念

    频道

    使用 Agora SDK 进行的所有通话都是在频道内发生的。我们把一个 App 比作一栋大楼的话,频道就好比大楼里面的一个房间。

    数据洞察在统计频道数时,会将每一次从有用户加入一个频道到所有用户离开频道计为一个频道(即使频道名相同也会按次数统计)。

    用户

    一个频道中的每个用户都有唯一的用户名用于标识身份。

    数据洞察在统计用户人数时,会将相同频道名且相同用户名的用户计为一个人。如果一个真实用户以不同的用户名加入一个频道或者以相同的用户名加入不同频道,均会被计算为多个用户。

    用量

    用量统计的是用户实际在频道内的时长。

    用户加入频道后,接收视频的时长计为视频用量,未接收视频的时长计为音频用量。

    离群值

    离群值是指与其他数值相比差异较大的数值。数据洞察的分布面板会将质量数据为离群值的以红色数字标记,提示可能存在异常的日期。