【北极星】RTC 问题排查工具详细使用说明

RTC 通话明细

音视频通话北极星是融云为开发者提供的通话质量实时监控工具,以图表形式展示每一通音视频通话的质量数据,旨在帮助开发者定位通话问题,提高问题解决效率。
目前支持针对使用融云实时音视频核心引擎 3.0 版本的音视频通话数据统计,支持的 SDK 版本详细如下:

  • Android RTCLib SDK 3.0.8 及以上版本的实时音视频 SDK
  • iOS RTCLib SDK 3.0.8 及以上版本的实时音视频 SDK
  • Web RTCLib SDK 3.1.0 及以上版本的实时音视频 SDK

注:目前 Web 端只支持在 Google Chrome 57 及以上版本的浏览器上进行音视频通话的数据统计。

质量指标

目前北极星提供以下质量指标数据:

  • 码率:音视频发送码率、接收码率
  • 网络丢包:上行丢包(用户发送音视频流到融云服务器的网络丢包)、下行丢包(融云服务器下发到目标用户的网络丢包)
  • 视频帧率及卡顿
  • 分辨率:视频发送分辨率、接收分辨率
  • 音量:音频本地采集音量、播放音量
  • 设备状态:包括 App 的 CPU 使用率和系统的 CPU 使用率

搜索通话

登录融云开发者后台,在 数据统计 中,北极星 部分,点击 音视频通话分析,即可查看某一个应用内,最近 7 天的通话记录(包括正在通话中,尚未结束的通话)。

支持通过:参与通话的用户 ID、房间名称、通话开始所在的时间范围,查询满足条件的通话记录。

查看某个用户的通话质量

选择一条通话记录,点击 查看详情,即可访问 通话质量页。通话质量页由 通话基本信息、用户通话列表 两部分组成。

1、通话基本信息 内展示通话 ID、房间名称、创建时间、销毁时间、房间创建总时长、参与通话总人数。

2、用户通话列表 部分,展示参与此次通话的所有用户的通话情况,包括该用户使用的 IMLib SDK 版本信息、RTCLib SDK 版本信息、设备版本信息、系统版本信息,以及通话质量图(该用户发送和接收的音视频质量信息)。

如果参与通话的用户很多,可以通过搜索 UID 查找想查看的用户通话情况。

3、通话质量图说明

  • 码率:曲线表示码率,四个质量图内分别为发送视频码率、发送音频码率、接收视频码率、接收音频码率;
  • 如果当前用户订阅了多个用户,则其接收到的视频码率、音频码率会有多条,以不同颜色区分展示来自不同用户的码率信息。
  • 丢包率:由橙色柱状图表示,为发送的数据,在上方两个质量图内,分辨是发送视频丢包率、发送音频丢包率;
  • 卡顿:由橙色柱状图表示,为接收的数据,在下方两个质量图内,分别为接收的视频卡顿时间、接收的音频卡顿时间。

注:鼠标移入图表,滑动鼠标滚轮可放大图表时间轴,查看详细时间点数据

分析通话详细质量指标

在通话质量页:

  • 点击 发送详情,查看该用户作为发送端的通话质量指标;
  • 点击 接收详情,查看该用户作为接收端,接收其订阅的发送端的通话质量指标信息。

注:鼠标移入图表,滑动鼠标滚轮可放大图表时间轴,查看详细时间点数据

详细指标页 展示当前页面用户作为发送端发送出去的音视频质量指标;以及该用户作为接收端,接收到的来自其订阅的用户发送的音视频质量指标。通过分析这些指标,你可以定位通话质量问题的出处。

如果当前用户订阅了来自多个用户的信息,而你只想查看某一个或多个问题发送端的情况,可以筛选一个或多个发送端信息。

如果将当前用户接收到的信息和对应的用户发送出的信息做对比,查看是否是发送端用户发送信号时的问题,可以点击 查看发送端,打开发送端用户的详细指标页,对比查看。

各项质量指标的含义如下:

码率

码率是数据传输时单位时间传输的数据位数。

音频码率越高则音质越好,视频同理。码率低不一定会导致通话质量有问题,不过过低的码率往往意味着音视频通话的质量较差。

丢包

丢包是指在数据传输过程中,数据包无法到达目的地而丢失了的情况。丢包率是指数据传输中,丢失的数据包数量占所有发送数据包数量的比率。

发送端的丢包是指数据发送过程的丢包,接收端的丢包指的是从融云服务端发送流到接收端的丢包。

轻微的丢包通常不会影响用户的体验,但是过高的丢包率一般意味着网络质量较差,可能会导致音视频的卡顿、视频模糊等现象。

帧率

帧率是称为帧的位图图像连续出现在显示器上的频率(速率)。

帧率越高视频播放越流畅,但也需要更多的带宽和 CPU,而帧率过低则会造成视觉上的卡顿现象。

分辨率

分辨率是屏幕图像的精密度,以水平和垂直的像素值来衡量。

接收的视频画面分辨率越高(像素值越大),则视频画面越清晰。

设备状态

App 以及操作系统的 CPU 占用率。如果用户使用的设备性能较差,CPU 占用率可能会过高,造成音视频卡顿。

注:

  • Android 8.0 及以上版本无法获取 CPU 占用率信息,通过监控 CPU 频率来展示 CPU 繁忙程度的。
  • iPhone 8、iPhone 8 Plus、iPhone X、iPhone XR iPhone Xs MAX,系统 CPU 占用率为单独核算,不包含 APP 的 CPU 使用率。

RTC 房间状态同步回调查询

北极星提供了 RTC 房间状态回调服务的问题排查,可查看每次回调的时间、URL、响应状态码及相应内容详情,当应用服务器没有收到相关回调时,可通过北极星回调查询回溯回调数据。

查询条件

支持根据以下查询条件,查询对应的回调事件:

  • 查询时段:发生回调时间的时段,时间精确到秒
  • 响应状态码:可通过回调的响应状态码筛选回调事件
  • 音视频房间 ID:可按照音视频房间 ID 精确查找筛选
  • 时间类型:支持通话 RTC 房间状态不同的事件类型进行筛选,快速定位事件

回调数据列表

基于对应的检索条件,可查询到该时段所有的回调事件,内容展示包含:

  • 回调时间,实际回调给应用服务器时间,精确到毫秒
  • 回调URL ,数据回调实际使用URL 地址
  • 响应状态码,应用服务器的响应状态码
  • 音视频房间 ID,回调事件隶属于哪个音视频房间
  • 事件类型,触发回调事件的事件类型

查看回调详情

点击查看按钮,可查看具体的回调内容。