发版说明

简介

水晶球（Agora Analytics）是 Agora 为开发者提供的全周期通话质量监测、回溯和分析的解决方案，致力于帮助你及时发现问题、定位原因，并最终解决问题以提升用户体验。详见水晶球概览。

2022.08

为了兼顾数据洞察的时效性和准确性，本次发布在数据洞察中增加数据重算机制。数据洞察的数据延迟最低可以达到 6 小时，但内部资源调度、用户网络不佳等原因可能导致数据上报的延迟。增加数据重算机制后，每天的数据都会在 T+2 天重新计算一次，以保证历史数据的完整性。例如，2022 年 7 月 6 日的数据将在 7 月 8 日凌晨进行重算。

2022.04

本次发布推出了通话调查的新版本。与旧版相比，新版通话调查具有以下优势：

• 针对大规模通话场景，提高从通话级别问题定位至用户级别问题的调查效率。
• 分开呈现接收端与发送端的关键质量指标与事件，方便定位异常问题。
• 集成自动诊断引擎，提供直观的诊断结论，帮助降低调查成本。与自动诊断引擎相关的功能目前均处于 beta 阶段。

详见通话调查流程总览。

2021.10

本次发布下线了实时数据（Beta）和实时预警（Beta），并且新增实时监控和告警通知功能：

• 实时监控：对 Agora RTC 项目提供多指标、可视化的实时监控。
• 告警通知：对 Agora RTC 项目的异常指标和事件提供告警，可以通过邮件、接口回调等多种方式发送告警通知。

此外还增加了实时监控 RESTful API，用于查询实时规模和实时质量。

2021.07

本次发布对数据洞察功能进行如下优化：

• 优化用量指标和质量指标，提供不同粒度的数据。
• 数据洞察 RESTful API 有如下改动：
  • 更新 /beta/insight/usage/by_time 接入点；
  • 新增 /beta/insight/quality/by_time（查询质量指标）接入点。

2021.05

本次发布对通话调查 RESTful API 进行如下改动：

• 更新 /beta/analytics/call/lists 接入点；
• 废弃 /beta/analytics/call/details（获取通话指标）接入点，并且新增 /beta/analytics/call/sessions（获取用户通话详情）和 /beta/analytics/call/metrics（获取通话质量指标）作为替代。

2020.09

新增特性

1. 大频道 RESTful API (Beta)

该版本新增大频道 RESTful API，你可以获取以下数据：

• 大频道中体验异常的用户数。体验异常包含视频卡顿、加入大频道慢等。
• 尝试加入大频道的用户数。
• 大频道中用户对通话的评分。
• 大频道的在线用户数。

改进

1. 通话调查

• 通话体验质量页面的事件轴移至端到端详情页面的音视频上行和网络丢包、音视频下行和端到端丢包面板。

• 端到端详情页面新增以下指标：

  • 视频大流发送码率
  • 视频小流发送码率
  • 视频采集帧率
  • 视频发送分辨率

• 支持在通话概览页面一键创建工单。

• 优化 UI 样式。

2. 其他改进

除 RESTful API 外，水晶球各功能默认使用本地时间。

2020.06

本次发布新增水晶球内嵌功能（Beta），帮助开发者快速在自己的系统中嵌入水晶球功能，减少对接成本并提升问题调查效率。详见水晶球内嵌。

2020.05

本次发布新增实时预警功能（Beta），实现实时异常识别、根因分析，帮助客户及时定位异常源。详见实时预警。

2020.01

本次发布新增大频道功能（Beta），实现频道级监控、异常识别，能极大提高用户运营大频道的效率。详见大频道。

2019.10

本次发布新增实时数据功能（Beta），帮助用户实时掌握项目动态，及时识别异常通话体验和异常根因。详见实时数据。

2019.09

本次发布新增数据洞察功能（Beta），提供整体、地域、版本的质量监控，用户可以历时分析通话规模和质量。详见数据洞察。

2019.08

本次发布新增关键事件功能，提升问题调查效率。

2018.08

本次发布提供通话调查功能，帮助用户查找通话并分析质量问题。详见通话调查。