The Call Search function of Agora Analytics allows you to see the quality of your calls in diagrams displaying data during the call process. The information includes:
- The device status, including the system CPU usage and the app's CPU usage.
- The local captured volume and the remote playout volume.
- The bitrate of the sent or received audio and video.
- The frame rate of the sent or received audio and video.
- The resolution of the sent or received video.
- The upstream bitrate and packet loss rate of the sent audio and video.
- The downstream bitrate and end-to-end packet loss rate of the received audio and video.
- The freeze time in rendering the audio and video.
- User events. For example, stop sending audio or start receiving video.
- The users' ratings of the call.
See the use case tutorials to learn how to analyze your calls.
Log in Agora Console and click Call Search under Agora Analytics on the left of the navigation bar.
To search calls, fill in the search fields:
- Select the project in the top-left corner.
- Specify the searching time frame (the default time frame is the last 14 days).
- Choose to search by Channel Name or User (user ID) in the drop-down menu.
- Filter the calls by the call states, and you can choose to search for calls that are ongoing or ended.
- Enter a channel name or user ID and click Search.
View Quality of Experience
You can go to the QoE page by clicking View the call on the search results page.
The QoE page shows each user's quality of experience as the receiver in the call. You can see whether any user experiences audio/video freeze, blurry video, or no audio or video. On this page, you can see the Basic information, the User list and the Quality of Experience Overview of the call from top to bottom.
The top of the QoE page shows the basic information of the call, such as the project name, channel name, starting and ending times, and duration of the call.
The user list shows the information of the users in the call, such as the user ID, the location, when the user joins/leaves the channel and the actual time in the channel (In-call Periods).
The View QoE toggle switch turns on/off displaying the QoE diagram for each user.
Quality of Experience Overview
The Quality of Experience Overview section displays each user's QoE diagram.
The user's basic information is shown above the QoE diagram, including the user ID, platform, SDK version, and user's ratings of the call (when the rating function is enabled).
In the QoE diagram, the x-axis represents the time of the call, and the y-axis represents the bitrate of the received video and audio.
- The curve above the x-axis represents the bitrate of the received video from the sender. For multiple senders, the received video from each sender is shown by a colored curve.
- The red dotted line indicates a blurry video.
- The red glitches above the x-axis indicate video freeze.
- The curve below the x-axis represents the total bitrate of the received audio from all senders.
- The red glitches below the x-axis indicate audio freeze.
If you find quality issues of a specific sender, click the End-to-End Details button to go to the E2E (End-to-End) page.
If you need support, click the bottom-right icon to submit a ticket.
Analyze quality issues
The End-to-End Details page shows the audio and video statistics of a specific sender and receiver. These statistics affect the user's quality of experience and help you understand the quality issues.
You can see the user's event timeline on the following diragrams:
- Audio Upstream Bitrate and Packet Loss
- Audio Downstream Bitrate and End-to-End Packet Loss
- Video Upstream Bitrate and Packet Loss
- Video Downstream Bitrate and End-to-End Packet Loss
Select the spikes on the timeline to see the user events. Pay attention to the red spikes, which represent important events, such as failure to join the channel.
The CPU usage of the system and the App, indicating how busy the system is. If the system is busy (the CPU usage is high), the audio/video may freeze.
You can find user events on the event timeline in the Quality of Experience Overview section and on the End-to-End Details page. There are red, yellow, and green spikes on the timeline, representing serious, general, and normal events:
- Serious events: Events that directly affect the call experience and make it difficult for receivers to see normal images. Such events occur when a user fails to join a channel, network connections fail, a user disables the audio/video module, or a user stops camera capturing.
- General events: Events that may affect the call experience to some extent. Such events occur when a user's network status is unknown, IP address changes, or a user stops sending audio/video streams.
- Normal events: Events that do not affect the call experience. Such events occur when a user successfully joins a channel, a user starts camera capturing, or a user receives the first audio/video frame.
The bitrate is the amount of data (bits) sent or received per second.
A higher audio/video bitrate means a higher audio/video quality. A low bitrate does not necessarily cause quality issues, but a very low bitrate often means poor audio/video quality.
Data is transmitted in units called packets. In data transmission, some of the packets are lost. The packet loss rate is the percentage of the lost packets, which reflects the network quality:
- The packet loss rate of the sender is the packet loss rate of sending the data.
- The packet loss rate of the receiver is the packet loss rate from the sender to the receiver.
A low packet loss rate usually does not cause any quality issue. A high packet loss rate (5% or higher) means the network quality is poor and may cause audio/video freeze and blurry video.
The frame rate is the frequency (rate) at which consecutive images (frames) appear on a display.
A higher frame rate means smoother video but uses more bandwidth and CPU usage. A low frame rate may cause video freeze.
The resolution is the number of pixels in the width and height of an image. A higher resolution means clearer video.
This section describes the key terms used in Call Search. See Agora Key Terms for more key terms.
Every call or interactive streaming must occur in a channel. If we imagine an app being a building, a channel will be a room in the building.
Many calls can occur in a channel. When a user joins an empty channel, a call starts. When all users leave the channel, this call ends. If a user joins the channel after the call ends, then a new call starts. The period between the first user joining a channel and the last user leaving the channel is considered one call.
Each user in the call has a unique user ID. Agora Analytics displays and analyzes the users' QoE from the perspective of sending and receiving data.
The QoE page shows the QoE of each user as the receiver.
A sender is a user sending data and has a speaker icon in the user list.
- A call's duration is the time from starting to ending the call, that is from the first user joining the channel to the last user leaving the channel.
- A user's duration is the time from the user joining to leaving the channel. A user may join and leave a channel multiple times in a call.
Actual time in the channel
The actual time in the channel reflects the actual minutes used in the channel for each user in the call.