功能介绍

通过通话洞察，您可以从流的维度监测和诊断音视频质量，定位音视频问题并进行根因分析，从而解决问题并最终提升用户体验。

说明

为了更好地使用星图，建议您使用 Express SDK 3.0 或以上版本，以便进一步提升数据上报的可靠性。

重点功能更新

2022 年 2 月发布新版通话洞察。和历史版本相比，具有如下变化：

新增功能

功能项	功能描述
用户规模评估	可查看推流用户在推流过程中的拉流用户数量（区分累计数和并发数），从而判断此条推流影响的用户规模。
用户行为轴	一览用户通话过程中的互动行为，您可借此判断音视频质量问题是否由用户行为导致，从而引导用户解决问题。
异常事件提示	主动暴露异常事件并在行为轴上标记，帮助您快速了解异常信息。

改进优化

功能项	功能描述
SDK 数据上报	完善指标、事件等相关数据的准确性。

2022 年 5 月发布自助诊断功能（beta 版），主动识别通话过程中的异常事件并进行归因，降低异常事件的排查门槛，提升异常排查效率。

功能概述

通话洞察包括以下 3 个子页面，分别承载不同功能：

子页面	功能
检索页	帮助您定位目标，从而进一步调查质量详情。
推流质量页	帮助您评估问题的影响范围以及规模，对问题定性。
端到端详情页	深入调查通话质量，还原用户互动情景，定位分析问题，最终解决问题以提升用户体验。

访问步骤

登录 ZEGO 控制台，从左侧导航栏进入星图；
在导航栏点击“通话洞察”，即可访问“检索页”。

检索页

页面示例

功能介绍

选择 AppID（必需），输入房间 ID、用户 ID 或流 ID（可选），选择需要查询的时间范围，点击查询，即可获取该时间范围内的流记录列表（即检索结果）。

增加多个筛选条件组合查询，或者缩小查询的时间范围，都可以更精准地搜索流记录信息。
流记录列表展示的字段包括：房间ID、推流用户ID、流ID、起止时间、操作。

注意
若用户在推流过程中产生了多次推流记录，则起止时间表示第一次推流的开始时间和最后一次推流的结束时间，您可以点击该时间范围旁的图标查看每次推流的时间等信息。
若通过用户 ID 检索，搜索结果会分为两个页签，分别展示该用户的推流记录和拉流记录，您可按 tab 键切换页签。
选择目标流，点击“查看推流质量"可进入推流质量页；点击“查看端到端质量"，将会展示此条推流对应的所有拉流用户，选择您想要查看的用户，进入端到端详情页；若用户较多，您也可以输入用户ID搜索。

推流质量页

页面示例

功能介绍

查看推流基本信息

在推流质量页上方，您可以查看推流的基本信息，包括用户 ID、SDK 版本、用户设备的系统和机型、用户所在的地区、用户使用运营商和网络信息。

当地区、网络等基本信息发生变化，会出现标识。将鼠标悬浮于此标识，即可查看完整的信息，以网络变化截图为例：
您还可以查看推流的发送码率、发送帧率、发送丢包率，以及发送延迟。如果您需要进一步了解各项数据的释义，请参考数据说明。

一览拉流用户列表

在推流质量页下方，您可以一览此条推流对应的所有拉流用户，并查看拉流时的质量情况（包含视频接收码率、音频接收码率、卡顿率）。如果您需要进一步了解各项数据的释义，请参考数据说明。

若列表用户较多，需要定位某个具体的拉流用户，可以通过输入用户 ID 检索定位此用户。

分析推流质量

在查看推流基本信息的时候，您可以参考以下方法分析推流质量：

发送码率和发送帧率图表的曲线波动越小，在 Y 轴对应的数值越接近目标设置值，则表示该用户推流越平稳，越符合您的设置目标。
发送丢包率和发送延迟图表，表示用户推流过程中的网络状况。曲线波动越小表示网络越稳定，Y 轴对应的值越趋近于 0，则网络质量越好。

例如，下图曲线发生了波动（红色框内的时间段），根据丢包和延迟的图表数据可以判断得出在这个时间段网络发生波动，导致推流的码率和帧率产生了变化，可能会导致画面出现卡顿、模糊等情况。

查看拉流用户体验

在查看拉流用户列表的时候，您可以参考以下方法分析拉流用户的体验：

通过接收码率的波动趋势，可以判断拉流用户的体验情况。码率曲线越平滑，波动越小，说明用户拉流时接收的数据越稳定，用户的体验越稳定；
卡顿率数据反映了用户是否产生了卡顿。如下图所示，红色范围表示用户拉流时产生卡顿的时间段；
数据的连续性可以帮助我们判断用户的拉流周期，数据间的间隔表示用户停止拉流。如下图示例，用户的此次音频拉流分为两段；
你可以通过选择下拉列中的 RTC 或 CDN 信息，仅查看用户拉流时候所使用的某类服务的数据。如下图示例，该用户拉流过程中使用了 RTC 和 CDN 两类服务。
推流质量页各项数据的定义及释义，请参考数据说明。

评估问题影响的规模

您可以判断问题是仅属于某个拉流用户的个体问题，还是此条流所有用户的群体问题，判断步骤如下：

查看是否所有拉流用户图表数据在相同的时间出现了相似的波动，且在同时刻，推流用户也发生了类似波动。

以下图为例：

可以看出拉流用户在相同的时间段曲线波动相似，且推流用户也具有相似的波动，则可以判断是因为推流用户的质量波动导致所有拉流用户在同一时刻产生了体验问题。
若在推流列表中，仅有某一个用户发生了卡顿，其余用户图表展示正常，则可以判断卡顿体验问题为该用户的特例问题，如下图所示：
若判断结论是因为推流用户导致，可以通过查看“拉流用户并发”看此条流的并发峰值人数和累计用户数，从而评估影响范围。

进一步调查互动质量

如果您想要进一步查看推流用户和拉流用户之间详细的互动质量和用户体验，可以选择访问端到端详情页。

端到端详情页

页面示例

功能介绍

通过端到端详情页，您可以调查、监测全链路通话质量，还原用户情景。

快速了解通话互动的基本情况

查看当前流的状态，状态包括：进行中、已结束。
根据“切换”按钮是否可以点击，判断两端用户之间是否有连麦行为。若推流端和拉流端有连麦行为，则”切换“按钮为可点击状态，您可以点击切换查看本端用户拉取对端用户所推的流时的质量详情；
如果你想要查看此条推流对应的其他拉流用户质量，可通过拉流用户旁边的标签展开拉流列表，选择更换。
通过“通话卡顿率”、“首帧耗时”、“音频体验”三个指标快速了解拉流用户基本体验，评估此次通话质量。如果您需要进一步了解各项数据的释义，请参考数据说明；
星图会主动识别通话过程中的异常事件，并根据异常事件的严重程度将事件区分为“异常”和“提醒”，直接在【通话诊断】展示诊断结果。您可以点击以查看异常详情及原因，从而低门槛、高效地定位异常。

对比查看推流端和拉流端的详情

你可以查看推流端和拉流端的用户基本信息、用户行为和流质量数据。

用户基本数据包括：用户 ID、SDK 版本、系统、机型、地区、运营商、网络、推流路径、拉流路径。
- 推流路径：表示推流从客户端到服务器的路径，如客户端 → RTC，表示客户端直接推流到 RTC 服务器；
- 拉流路径：表示拉流从服务器到客户端的路径，如 CDN → 客户端，表示客户端是从 CDN 节点拉流。
若信息发生了变化，可以点击信息旁边的图标展开查看。
用户行为：详细展示各个时刻的用户操作，完整还原整个通话互动过程，可帮助排查音视频质量问题是否是由用户行为导致。

下表列举部分典型事件：

分类	事件	事件描述
房间事件	登录、退出房间	表示用户登录房间和退出房间的时刻，帮助了解用户在房间中的状态。
流事件	开始、结束推流	表示用户开始和结束推流的时刻，帮助了解推流周期。
流事件	开始、结束拉流	表示用户开始和结束拉流的时刻，帮助了解拉流周期。
用户行为	打开、关闭麦克风	推流用户打开或关闭麦克风可能会导致拉流端用户听不到声音。
	打开、关闭摄像头	推流用户打开或关闭摄像头可能会导致拉流端用户看不到画面。
	打开、关闭扬声器	拉流用户打开或关闭扬声器可能会导致听不到声音。
	切换App至前后台	用户切换前后台可能导致推流或拉流中断。
	切换网络类型	切换网络类型可能导致网络质量变化。
异常事件	房间登录请求异常	用户登录房间失败，可以查看异常原因，从而解决问题，例如“请求超时，可能是因为网络较差导致”，可以引导用户切换网络解决此异常。
	房间异常退出	用户异常退出房间，可以查看异常原因，从而解决问题，例如“连接中断，可能是网络断开导致”，可以引导用户重新连接网络解决此异常。
	请求推流异常	用户推流异常导致推流失败，可以查看异常原因，从而解决问题，例如“推流参数设置错误”，可以调整推流参数重新推流解决此异常。
	异常结束推流	用户推流过程中异常断开，可以查看异常原因，从而解决问题，例如“连接中断，可能是网络断开导致”，可以引导用户重新连接网络解决此异常。
	请求拉流异常	用户拉流异常导致拉流失败，可以查看异常原因，从而解决问题，例如“流不存在”，可能是推流端还异常没有成功推流导致，可以引导用户等待推流后再进行拉流解决。
	异常结束拉流	用户拉流过程中异常断开，可以查看异常原因，从而解决问题，例如“连接中断，可能是网络断开导致”，可以引导用户重新连接网络解决此异常。
	设备异常中断等相事件	用户在推拉流过程中设备异常，可以查看异常原因，从而解决问题，例如“设备没有权限“，可以引导用户进行授权解决此异常。

推/拉质量数据，包括码率、帧率、丢包率、延迟、分辨率、音量、CPU 使用率以及内存使用量，帮助您判断评估音视频质量，并对质量问题进行归因。如果您需要进一步了解各项数据的释义，请参考数据说明。