跳到主要内容

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、房间名称、通话开始所在的时间范围，查询满足条件的通话记录。

ab

查看某个用户的通话质量

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

1、通话基本信息

内展示通话 ID、房间名称、创建时间、销毁时间、房间创建总时长、参与通话总人数。 ac

2、用户通话列表

展示参与此次通话的所有用户的通话情况，包括该用户使用的 IMLib SDK 版本信息、RTCLib SDK 版本信息、设备版本信息、系统版本信息，以及通话质量图（该用户发送和接收的音视频质量信息）。如果参与通话的用户很多，可以通过搜索 UID 查找想查看的用户通话情况。 ad

3、通话质量图说明

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

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

ae

分析通话详细质量指标

在通话质量页

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

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

af

详细指标页

展示当前页面用户作为发送端发送出去的音视频质量指标；以及该用户作为接收端，接收到的来自其订阅的用户发送的音视频质量指标。通过分析这些指标，你可以定位通话质量问题的出处。如果当前用户订阅了来自多个用户的信息，而你只想查看某一个或多个问题发送端的情况，可以筛选一个或多个发送端信息。

ag

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

ah

各项质量指标的含义如下

  • 码率：码率是数据传输时单位时间传输的数据位数。音频码率越高则音质越好，视频同理。码率低不一定会导致通话质量有问题，不过过低的码率往往意味着音视频通话的质量较差。
  • 丢包：丢包是指在数据传输过程中，数据包无法到达目的地而丢失了的情况。丢包率是指数据传输中，丢失的数据包数量占所有发送数据包数量的比率。发送端的丢包是指数据发送过程的丢包，接收端的丢包指的是从融云服务端发送流到接收端的丢包。 轻微的丢包通常不会影响用户的体验，但是过高的丢包率一般意味着网络质量较差，可能会导致音视频的卡顿、视频模糊等现象。
  • 帧率：帧率是称为帧的位图图像连续出现在显示器上的频率（速率）。帧率越高视频播放越流畅，但也需要更多的带宽和 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 房间状态回调服务的问题排查，可查看每次回调的时间、URL、响应状态码及相应内容详情，当应用服务器没有收到相关回调时，可通过北极星回调查询回溯回调数据。

查询条件

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

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

回调数据列表

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

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

ai

查看回调详情

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

aj

最后于 更新