Skip to main content

Data Insights

Data Insights are is designed to help you understand the usage and quality of calls in your app. You can view their distribution in multiple dimensions with daily and hourly data breakdown.

Getting started

  1. Subscribe to a pricing plan to enable the Data Insights feature for your project.

  2. Login to Agora Console and click Agora Analytics on the left navigation bar.

  3. Select a project in the top-left corner. 1626938912317

  4. Click Usage Overview to view the usage statistics or Quality Overview to view the quality statistics.

  5. Configure the data filter:

  • Usage Overview: Select the timezone, data granularity, and time frame in the upper-right corner. 1626938934348

  • Quality Overview: Select the product type in the upper-left corner, and the timezone, data granularity, and time frame in the upper-right corner. 1626938949680

Usage Overview

The Usage Overview page presents Overall Trend and Metric Analysis for usage metrics, which can help you locate the dates with abnormalities and understand how usage is distributed in different dimensions.

The usage data provided in the Usage Overview page is for reference only and is not used for billing calculation.

Overall Trend

The Overall Trend panel has three sections: Peak traffic, Channel and user count, and Service minutes. In each section, the summary boxes in the upper-left corner highlight the aggregate or peak value of each usage metric, and the line chart in the bottom area shows the daily values of each usage metric. You can click All data in the top-right corner of each section to download the data or view it in table form.

The usage metrics are described in Usage metrics.

Each line chart provides the following features:

  • Hide and display: To hide or display the line for a usage metric, click on the corresponding summary box.

  • Change time selection: When data granularity is set to By day in the data filter, you can click a data point and select Hourly data, which changes the data granularity to hourly and the time frame to the corresponding hour. To switch back to the original time selection, click Restore filter in the upper-center area of the Overall Trend panel.

  • Jump to Metric Analysis: To jump to the Metric Analysis panel of a usage metric for a specific day, click the corresponding data point on the line, and select Metric Analysis. If you want to use the previously selected time frame, click Reset time in the upper-left area of the Metric Analysis panel.

Metric Analysis

The Metric Analysis panel has six sections: Geography, Network type, Operating system, SDK version, Device type, and Channel size. Each section presents the top six values for that dimension in bar-chart form.

In the top-right corner of the panel, you can select the usage metric you want to view. In the top-right corner of each section, you can click All data to download the data or view it in table form.

1626938976055

The six dimensions are described in Dimensions.

Quality Overview

The Quality Overview page presents Overall Trend and Metric Analysis for quality metrics, which can help you locate the dates and hours with abnormalities and understand how quality is related to usage in different dimensions.

Overall Trend

The Overall Trend panel has two sections: User experience and Success at joining channels. In each section, the summary boxes in the upper-left corner highlight the peak or bottom value of each quality metric, and the line chart in the bottom area shows the daily or hourly values of each quality metric. You can click All data in the top-right corner of the section to download the data or view it in table form.

The quality metrics are described in Quality metrics.

Each line chart provides the following features:

  • Hide and display: To hide or display the line for a quality metric, click on the corresponding summary box.

  • Change time selection:

  • When data granularity is set to By day in the data filter, you can click a data point and select Hourly data, which changes the data granularity to hourly and the time frame to the corresponding hour. To switch back to the original filter setting, click Restore filter in the upper-center area of the Overall Trend panel.

  • When data granularity is set to By hour in the data filter, you can click a data point and select Minutely data, which changes the data granularity to minutely and the time frame to the corresponding minute. To switch back to the original filter setting, click Restore filter in the upper-center area of the Overall Trend panel.

  • Jump to Metric Analysis: To jump to the Metric Analysis panel of a quality metric for a specific day or hour, click the corresponding data point on the line, and select Metric Analysis. If you want to use the previously selected time frame, click Reset time in the upper-left area of the Metric Analysis panel.

Additionally, the line chart for User experience provides the data sampling feature:

  • Channel data sampling: When data granularity is set to By day or By minute, click a data point and select Channel data sampling to view its scatter chart. The x coordinates are described in Quality metrics.

  • User data sampling: On the scatter chart, click a data point and select User data sampling to view the top six users who experience a high freeze rate. To view call quality details about a user, click Call Inspector to use the Call Inspector function.

Metric Analysis

The Metric Analysis panel has six sections: Geography, Network type, Operating system, SDK version, Device type, and Channel size. Each section presents the connection between quality and usage in bubble-chart form.

In the top-right corner of the panel, you can select the quality metric you want to view. In the top-right corner of each section, you can click All data to download the data or view it in table form.

1626938998631

The six dimensions are described in Dimensions.

In the country and region bubble charts, the Y coordinate is the value of the selected metric, and the corresponding X coordinate is listed in Quality metrics. The bubble color represents whether the metric value is normal. The bubble turns red if one of the following occurs:

  • The video freeze rate exceeds 5%.
  • The audio freeze rate exceeds 3%.
  • The network delay rate exceeds 10%.
  • The success rate of users joining channels is below 95%, or the success rate of users joining channels within 5 seconds is below 95%.

Key terms

This section describes the key terms used in Data Insights. See Agora Key Terms for more key terms.

Channel

Every audio or video call happens in a channel. If an app is a building, a channel is a room in the building.

Data Insights does not count a channel by name, but by lifecycle. A channel is counted once for each period of time between when the first user joins it until the last user leaves it. That is, it is not counted when there are no users.

User

Each user in a channel is identified by a unique user ID. There can never be two identical user IDs in a channel.

Data Insights counts each instance of a unique user ID. If a real-life user joins one channel using multiple user IDs, or joins multiple channels using one user ID, Data Insights counts the user in both situations as multiple users.

Usage metrics

Usage metricDescription
Peak channel trafficThe maximum number of channels in use.
Peak user trafficThe maximum number of in-call users across all channels.
Total number of channelsA channel is counted once for each period of time between when the first user joins it until the last user leaves it.
Total number of usersThe number of users across all channels. A user joining one channel using multiple user IDs or joining multiple channels using one user ID is counted multiple times.
Total count of users joining channelsEach time any user ID joins any channel is counted.
Total minutesThe total duration of video and audio-only calls calculated by the number of users.
Video minutesThe total duration of video calls calculated by the number of users.
Audio minutesThe total duration of audio-only calls calculated by the number of users

Quality metrics

Quality metricDescriptionX coordinate in scatter chart
Video freeze rateThe rate at which video freezing occurs, which equals Total video freeze time ÷ Total video minutes calculated by the number of streams. Only video freezes longer than 600 milliseconds are counted.Total video minutes calculated by the number of streams
Audio freeze rateThe rate at which audio freezing occurs, which equals Total audio freeze time ÷ Total audio minutes calculated by the number of streams. Only audio freezes longer than 200 milliseconds are counted.Total audio minutes calculated by the number of streams
Network delay rateThe rate at which network delay occurs, which equals Total end-to-end network delay ÷ Total audio and video minutes calculated by the number of streams. Only end-to-end network delays longer than 400 milliseconds are counted.Total audio and video minutes calculated by the number of streams
Success rate of users joining channelsThe rate at which users attempting to join any channel succeed, which equals Number of users who have joined ÷ Number of attempts to joinNumber of attempts to join a channel
Success rate of users joining channels within 5 secondsThe rate at which users attempting to join any channel succeed within 5 seconds, which equals Number of users who have joined within 5 seconds ÷ Number of attempts to joinNumber of attempts to join a channel

Dimensions

DimensionDescription
GeographyThe country and region from which the user connects.
Network typeThe user’s network type, such as Wi-Fi or 4G.
Operating systemThe user’s operating system, such as Windows or iOS.
SDK versionThe version number of the SDK that implements the call.
Device typeThe user’s device type.
Channel sizeThe number of users in the channel.

Calculating usage by the number of users vs. by the number of streams

There are two different approaches to calculating Video SDK service minutes for a channel: by the number of users in the channel, and by the number of streams each user is subscribed to in the channel. Their difference is described in How does Agora calculate service minutes.

Data sampling criteria

Line charts under the Overall Trend panel on the Quality Overview page support data sampling. The data sampling criteria is defined as follows:

Line chartData sampling criteria
Video freeze rateThe video freeze rate exceeds 5%, and the video minutes across all channels exceed 100 in one minute.
Audio freeze rateThe audio freeze rate exceeds 3%, and the audio minutes across all channels exceed 100 in one minute.
Network delay rateThe network delay rate exceeds 10%, and the total minutes across all channels exceed 100 in one minute.

Page Content