Updated on 2023-10-16 GMT+08:00

Diagnostics

You can view information about all users with abnormal call experience and exception details in real time to quickly identify the types and causes of call exceptions.

Notes

The latest data will be displayed at most 5 minutes after it is generated.

About Query

  • You can query the real-time data of the last 24 hours.
  • You can query data in a time span of up to 24 hours.

Procedure

  1. Log in to the SparkRTC console.
  2. In the navigation pane on the left, choose Analytics (Beta) > Diagnostics.
  3. On the displayed page, enter or select an app ID to view all call exception data of the target app.

    The diagnosis data chart displays the following information: user data by exception type, exception causes, and details about all users with abnormal call experience.

    • Overview

      Displays user data by exception type, including Users with slow loading, Users with audio freeze, and Users with video freeze.

      • Users with audio freeze: indicates the number of users who take a long time to join a room
      • Users with audio freeze: indicates the number of users who have audio freezes during calls
      • Users with video freeze: indicates the number of users who have video freezes during calls
    • Exception Causes

      Displays details about the exception causes in a specified period, including exception types and the proportion and number of affected users by exception. For details about the exception causes, see Table 1.

      Note: In the statistical chart, if the number of data items is less than or equal to 5, all exception causes and their proportions are displayed in descending order. If the number of data items is greater than 5, the fifth one and all data items following it are classified as Other and displayed as the fifth item in descending order.

      • Type: indicates the type of a call experience exception, including slow room loading, video freeze, and audio freeze
      • Cause: indicates the cause of a call experience exception. For details, see Table 1.
      • Proportion: indicates the proportion of the number of users affected by an exception
      • Users: indicates the number of users affected by an exception
      Table 1 Exception cause description

      Cause

      Detection Threshold

      Heavy system CPU usage

      80%

      Heavy app CPU usage

      70%

      Uplink audio latency

      500 ms

      Uplink audio jitter

      500 ms

      Uplink video latency

      500 ms

      Uplink video jitter

      500 ms

      Downlink audio latency

      500 ms

      Downlink audio jitter

      500 ms

      Downlink video latency

      500 ms

      Downlink video jitter

      500 ms

      Uplink audio packet loss

      20%

      Uplink video packet loss

      20%

      Downlink audio packet loss

      20%

      Downlink video packet loss

      20%

      Downlink video freeze

      5%

      Downlink audio freeze

      3%

    • Exception Details

      Displays details about all users with abnormal call experience, including the call time, room ID, username, and the phase, type, cause, and source of an exception.

      • Phase: indicates the phase where a call experience exception occurs, including joining a room and making a call
      • Type: indicates the type of a call experience exception, including slow room loading, video freeze, and audio freeze
      • Cause: indicates the cause of a call experience exception. For details, see Table 1.
      • Source: indicates the call experience exception source, which can be either a local user or a remote user