数据洞察

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

使用步骤

1. 订阅水晶球套餐包，开通数据洞察功能。
2. 登录控制台，点击左侧菜单栏中的水晶球。
3. 在页面左上方的下拉菜单中选择你要查看的项目。
4. 点击数据洞察下的用量概览查看用量数据，或者点击质量概览查看质量数据。
5. 设置筛选条件：
   • 用量概览：在页面右上角选择时区（北京时间或 UTC 时间）、数据粒度（按天或按小时）、时间范围。
   • 质量概览：在页面左上角选择客户端类型（Native 或 Web RTC），右上角指定时区（北京时间或 UTC 时间）、数据粒度（按天、小时或分钟）、时间范围。

用量概览

用量概览页面由总览和多维分析两个面板组成，可以帮助你定位用量异常的时间，了解产生用量的主要国家和地区、操作系统等。

总览

总览面板包含最大在线、频道和用户、用量分析三个版块。每个版块上方以卡片显示指标的累计值或峰值及达到峰值的时间，下方以曲线图展示指标随时间变化的趋势。你可以点击版块右上角的更多，以表格形式查看数据或下载数据到本地。例如：

各指标的含义详见用量指标。

总览面板的每个曲线图都提供以下功能：

• 隐藏和显示：点击上方的指标卡片可以隐藏对应的曲线，再次点击则恢复显示。
• 修改时间筛选条件：如果筛选条件设为按天，可以点击曲线图上的数据点，然后点击查看小时，将数据粒度切换到按小时、时间范围切换到对应日期的 24 小时，此时各项指标和曲线图都会相应更新。查看完毕后，可以点击返回原始时间，恢复原来的筛选条件。
• 快速查看多维分析：点击曲线图上的数据点，然后点击查看分布，可以跳转到该数据点对应时间的多维分析面板，查看对应指标在各个维度的数据。查看完毕后，可以点击重置时间，恢复原来的筛选条件。

多维分析

多维分析面板包含地域、网络类型、操作系统、SDK 版本、设备类型、频道规模六个版块，每个版块以条形图展示用量指标在各个维度排名前六的数据。

在多维分析面板的右上角，你可以选择要查看的用量指标。在各个维度版块的右上角，你可以点击更多，以表格形式查看所有用量指标在该维度的数据，或者下载数据到本地。例如：

各维度的含义详见维度。

质量概览

质量概览页面由总览和多维分析两个面板组成，可以帮助你定位质量异常的时间，从多个维度了解质量与用量的关系。

总览

总览面板包含用户体验和加入频道两个版块。每个版块上方以卡片显示指标的峰值或谷值以及达到该值的时间，下方以曲线图展示指标随时间变化的趋势。你可以点击版块的更多，以表格形式查看数据或下载数据到本地。例如：

各指标的含义详见质量指标。

总览面板的每个曲线图都提供以下功能：

• 隐藏和显示：点击上方的指标卡片可以隐藏对应的曲线，再次点击则恢复显示。
• 修改时间筛选条件：
  • 如果筛选条件设为按天，可以点击曲线图上的数据点，然后点击查看小时，将数据粒度切换到按小时、时间范围切换到对应日期的 24 小时，此时各项指标和曲线图都会相应更新。点击页面上方的返回原始时间可以恢复到最初始的筛选条件。
  • 如果筛选条件设为按小时，可以点击曲线图上的数据点，然后点击查看分钟，将数据粒度切换到按分钟、时间范围切换到对应小时的 60 分钟，此时各项指标和曲线图都会相应更新。点击页面上方的返回原始时间可以恢复到最初始的筛选条件。
• 快速查看多维分析：点击曲线图上的任一数据点，然后点击查看分布，可以跳转到该数据点对应时间的多维分析面板，查看对应指标在各个维度的数据。查看完毕后，可以点击重置时间，恢复原来的筛选条件。

此外，用户体验版块下的曲线图还提供数据采样功能：

• 频道采样：如果筛选条件设为按小时或按分钟，点击曲线图上的数据点，然后点击频道数据采样，可以看到对应时间的散点图。散点图的纵坐标为对应的指标，横坐标详见质量指标。
• 用户采样：在频道数据采样的散点图上，点击数据点，然后点击用户数据采样，可以看到频道中卡顿率最高的六位用户的数据。

多维分析

多维分析面板包含地域、网络类型、操作系统、SDK 版本、设备类型、频道规模六个版块。在多维分析面板的右上角，你可以选择要查看的质量指标。在各个维度版块的右上角，你可以点击更多，以表格形式查看所有质量指标在该维度的数据，或者下载数据到本地。例如：

各维度的含义详见维度。

气泡图展示所选的质量指标在当前维度下与用量的关系，纵坐标为所选指标，对应的横坐标详见质量指标。绿色气泡表示指标数据正常，红色气泡表示指标数据异常，异常情况包括：

• 视频卡顿率大于 5%
• 音频卡顿率大于 3%
• 网络延迟率大于 10%
• 登录成功率或 5s 登录成功率大于 0.5%

重要概念

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

频道

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

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

用户

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

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

用量指标

质量指标

维度

按流计算

在按流计算的方式下，如果一个用户同时订阅了多路音视频流，其接收的每路音视频流都会纳入时长用量的计算。例如：用户 A 同时和用户 B、C、D 视频10分钟，那用户 A 按流计算的视频时长为 30 分钟。

采样规则

质量概览页面总览版块下的曲线图支持数据采样功能。各指标的采样规则如下：