发版说明
水晶球（声网 Analytics）是声网为开发者提供的全周期通话质量监测、回溯和分析的解决方案，致力于帮助你及时发现问题、定位原因，并最终解决问题以提升用户体验。详见水晶球概览。
2023.09
本次发布全面升级了通话调查 RESTful API：
- 获取频道信息 API 响应内容新增通话峰值人数、累计通话人数、音频/视频卡顿率。
- 获取用户信息 API 响应内容新增用户级别音频/视频卡顿率和用户角色和功能标识。
- 获取用户质量明细指标 API 响应内容中的指标 ID 细化了视频分辨率指标，现在视频大流和小流的分辨率指标将独立展示。
- 新增获取通话统计数据 API 用于获取指定通话在指定时间范围内、指定维度下的音频/视频卡顿率统计数据。
- 新增获取通话卡顿率分桶数据 API 用于获取指定通话在指定时间范围内的音频/视频卡顿率分桶统计数据。
- 新增获取频道时序指标 API 用于获取指定通话的洞察统计数据。
2023.08
数据洞察 Plus
本次发布新增数据洞察 Plus 功能，相比原有数据洞察功能新增以下能力：
- 多维度分解，层层下钻快速归因
- 用户采样，确认问题影响范围
- 多指标、多时间窗指标对比，进一步提升分析效率
数据洞察 Plus 功能在专业版与旗舰版套餐包中支持，更多详情请参考以下文档：
2023.04
2023.03
本次发布升级了实时音视频（RTC）产品下的部分 RESTful API：
- 数据洞察 RESTful API
- 实时监控 RESTful API
- 查询实时规模和查询实时质量接口新增
dimension和dimensionValues参数，用于指定查询维度。 - 新增查询实时规模 Top 20 分组接口，用于获取指定维度下实时的通话人数的 TOP 20 分组数据。
- 新增查询实时质量 Top 20 分组接口，用于获取指定维度下的质量相关指标 TOP 20 分组数据。
- 查询实时规模和查询实时质量接口新增
2022.09
本次发布改进了视频卡顿率的计算方式。通过优化数据采集与分析方法、消除屏幕共享等特殊场景的影响，进一步提高了视频卡顿率的精度。视频卡顿率的这项改进适用于以下功能：
- 通话调查
- 数据洞察
- 实时监控
- 告警通知
2022.08
为了兼顾数据洞察的时效性和准确性，本次发布在数据洞察中增加数据重算机制。数据洞察的数据延迟最低可以达到 6 小时，但内部资源调度、用户网络不佳等原因可能导致数据上报的延迟。增加数据重算机制后，每天的数据都会在 T+2 天重新计算一次，以保证历史数据的完整性。例如，2022 年 7 月 6 日的数据将在 7 月 8 日凌晨进行重算。
2022.04
本次发布推出了通话调查的新版本。与旧版相比，新版通话调查具有以下优势：
- 针对大规模通话场景，提高从通话级别问题定位至用户级别问题的调查效率。
- 分开呈现接收端与发送端的关键质量指标与事件，方便定位异常问题。
- 集成自动诊断引擎，提供直观的诊断结论，帮助降低调查成本。与自动诊断引擎相关的功能目前均处于 Beta 阶段。
详见通话调查流程总览。
2021.10
本次发布下线了实时数据（Beta）和实时预警（Beta），并且新增实时监控和告警通知功能：
- 实时监控：对声网 RTC 项目提供多指标、可视化的实时监控。
- 告警通知：对声网 RTC 项目的异常指标和事件提供告警，可以通过邮件、接口回调等多种方式发送告警通知。
此外还增加了实时监控 RESTful API，用于查询实时规模和实时质量。
自 2021 年 10 月 12 日起，实时数据（Beta）和实时预警（Beta）全面下线。如需继续使用实时数据（Beta）功能，请升级到实时监控服务。详见计费说明。
2021.07
2021.05
本次发布对通话调查 RESTful API 进行如下改动：
- 更新
/beta/analytics/call/lists接入点； - 废弃
/beta/analytics/call/details（获取通话指标）接入点，并且新增/beta/analytics/call/sessions（获取用户通话详情）和/beta/analytics/call/metrics（获取通话质量指标）作为替代。
2020.09
该版本新增大频道 RESTful API，你可以获取以下数据：
- 大频道中体验异常的用户数。体验异常包含视频卡顿、加入大频道慢等。
- 尝试加入大频道的用户数。
- 大频道中用户对通话的评分。
- 大频道的在线用户数。
使用大频道 RESTful API 前，你需要联系销售开通大频道功能。
本次发布提升了通话调查功能的易用性，改进项包括：
-
通话体验质量页面的事件轴移至端到端详情页面的音视频上行和网络丢包、音视频下行和端到端丢包面板。
-
端到端详情页面新增以下指标：
- 视频大流发送码率
- 视频小流发送码率
- 视频采集帧率
- 视频发送分辨率
-
支持在通话概览页面一键创建工单。
-
优化 UI 样式。
除 RESTful API 外，水晶球各功能默认使用本地时间。
2020.06
本次发布新增水晶球内嵌功能（Beta），帮助开发者快速在自己的系统中嵌入水晶球功能，减少对接成本并提升问题调查效率。
2020.05
本次发布新增实时预警功能（Beta），实现实时异常识别、根因分析，帮助客户及时定位异常源。
2020.01
本次发布新增大频道功能（Beta），实现频道级监控、异常识别，能极大提高用户运营大频道的效率。
2019.10
本次发布新增实时数据功能（Beta），帮助用户实时掌握项目动态，及时识别异常通话体验和异常根因。
2019.09
本次发布新增数据洞察功能（Beta），提供整体、地域、版本的质量监控，用户可以历时分析通话规模和质量。
2019.08
本次发布新增关键事件功能，提升问题调查效率。
2018.08
本次发布提供通话调查功能，帮助用户查找通话并分析质量问题。