Help Center/ SparkRTC/ User Guide/ Analytics (Beta)/ Real-Time Data
Updated on 2023-10-16 GMT+08:00
View PDF
Share

Real-Time Data

You can view the real-time data and its analysis charts to check the scale, experience, and network indicators of voice and video calls. The data informs you of the overall project status in real time so that you can quickly identify abnormal calls and their root causes.

Notes

  • Data in Real-Time Data is for data analysis and quality issue query only. Services are charged based on bills.
  • 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) > Real-Time Data.
  3. On the displayed page, enter or select an app ID to view the real-time monitoring data of the target app.
  4. You can view the following real-time monitoring data of a call project:

    • Dashboard: displays the quantity of online users/rooms, quality, and exceptions
    • Scale: displays the online user-related data within a specified time range
    • Experience: displays the experience data within a specified time range
    • Network: displays the network data within a specified time range

Dashboard

Click the Dashboard tab to check the overall project status, including the number of online rooms/users, success rate of joining a room in 5 seconds, audio/ video smoothness, and call exceptions.

  • Online Rooms: A room is online after the first user joins the room and before the last user leaves it.
  • Online Users: indicates the number of online users. If a user joins n rooms using the same username, the number is n (n > 1).
  • Room Loaded in 5s: Number of users who join a room in 5 seconds / Number of users who attempt to join a room
  • Smooth Audio: (Total audio duration – Audio freeze duration) / Total audio duration. The audio freeze duration is counted once it reaches 200 ms.
  • Smooth Video: (Total video duration – Video freeze duration) / Total video duration. The video freeze duration is counted once it reaches 600 ms.
  • The number of online users in each region is displayed in the map of China.
  • Alarms: This area is displayed only when an exception occurs. A maximum of 6 alarms can be displayed. Table 1 lists the abnormal events and their respective detection thresholds.
    Table 1 Abnormal event description

    Abnormal Event

    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%

Scale

Click the Scale tab to check the number of online rooms and online users and how these two indicators change within a specified time range. You can also view the number of online users in different regions, as well as the network types, OSs, and SDK versions of online users.

In the upper part of the page, you can adjust the desired time range and specify whether to update chart data in real time.

  • Overview: displays the number of online rooms and online users and how these two indicators change within a specified time range
    • Online rooms: A room is online after the first user joins the room and before the last user leaves it.
    • Online users: indicates the number of online users. If a user joins n rooms using the same username, the number is n (n > 1).
  • Distribution: Regions are sorted by the number of online users in descending order. The number of online users in each region and its proportion to the total number of online users are displayed.
  • Network Types: Network types are sorted by the number of online users in descending order. The number of online users of each network type and its proportion to the total number of online users are displayed.

    Note: In the statistical chart, if the number of data items is less than or equal to 5, all network types 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.

  • OSs: Operating systems are sorted by the number of online users in descending order. The number of online users of each OS and its proportion to the total number of online users are displayed.

    Note: In the statistical chart, if the number of data items is less than or equal to 5, all OSs 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.

  • SDK Versions: SDK versions are sorted by the number of online users in descending order. The number of online users of each SDK version and its proportion to the total number of online users are displayed.

    Note: In the statistical chart, if the number of data items is less than or equal to 5, all SDK versions 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.

Experience

Click the Experience tab to check the success rate of joining a room and that of joining a room in 5 seconds, audio and video freeze rates, and successful stream push/pull. You can also view the number of online users by network type, OS, and SDK version, as well as the experience data (real-time or within a specified time range).

In the upper part of the page, you can adjust the desired time range and specify whether to update chart data in real time.
  • Overview: displays the success rate of joining a room and that of joining a room in 5 seconds, audio and video freeze rates, and success rates of pushing and pulling streams
    • Room loaded: Number of users who join a room / Number of users who attempt to join a room
    • Room loaded in 5s: Number of users who join a room in 5 seconds / Number of users who attempt to join a room
    • Audio freeze: Audio freeze duration / Total audio duration. The audio freeze duration is counted once it reaches 200 ms.
    • Video freeze: Video freeze duration / Total video duration. The video freeze duration is counted once it reaches 600 ms.
    • Successful stream pull: Number of successful audio and video playback times / Total number of playback times
    • Successful stream push: Number of successful audio and video stream pushes / Total number of stream pushes
  • Distribution: Regions are sorted by the number of online users in descending order. The Room loaded, Room loaded in 5s, Audio freeze, Video freeze, Successful stream pull, and Successful stream push of each region are displayed. For details about the data items, see Overview under the Experience tab.
  • Network Types: Network types are sorted by the number of online users in descending order. The Room loaded, Room loaded in 5s, Audio freeze, Video freeze, Successful stream pull, and Successful stream push of each network type are displayed. For details about the data items, see Overview under the Experience tab.

    Note: In the statistical chart, if the number of data items is less than or equal to 5, all network types 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.

  • OSs: OSs are sorted by the number of online users in descending order. The Room loaded, Room loaded in 5s, Audio freeze, Video freeze, Successful stream pull, and Successful stream push of each OS are displayed. For details about the data items, see Overview under the Experience tab.

    Note: In the statistical chart, if the number of data items is less than or equal to 5, all OSs 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.

  • SDK Versions: The SDK versions are sorted by the number of online users in descending order. The Room loaded, Room loaded in 5s, Audio freeze, Video freeze, Successful stream pull, and Successful stream push of each SDK version are displayed. For details about the data items, see Overview under the Experience tab.

    Note: In the statistical chart, if the number of data items is less than or equal to 5, all SDK versions 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.

Network

Click the Network tab to view the high-quality audio and video upload rates of the client and those of each region.

In the upper part of the page, you can adjust the desired time range and specify whether to update chart data in real time.
  • Overview: displays the high-quality audio and video upload rates of clients
    • HQ video upload: indicates the high-quality video upload rate from the sender to SparkRTC
    • HQ audio upload: indicates the high-quality audio upload rate from the sender to SparkRTC
  • Distribution: Regions are sorted by the number of online users in descending order. The high-quality audio and video upload rates of clients in each region are displayed. For details about the data items, see Overview under the Network tab.
Parent topic: Analytics (Beta)