Call Inspector Overview

Introduction

A new version of Call Inspector was released on May 5, 2022. This new version has the following advantages over the previous version:

• Locating user-specific issues through call-specific issues is more efficient, especially for large-scale calls.
• Key quality metrics and events now offer receiver's and sender's views, making it convenient to locate exceptions.
• Agora's auto-diagnosis engine is fully integrated to reduce the time cost of inspecting a call through intuitive conclusions. All features related to the auto-diagnosis engine are currently in beta.

Feature overview

The new Call Inspector provides the following features:

• Find a call or a group of calls. See Use Call Search.
• Determine the overall call quality in a channel. See Get Call Overview.
• Dive into user-specific metrics and events. See View Call Details.
• Examine user experience issues. See View Call Diagnosis (Beta).

The following workflow shows how to use the Call Inspector features together:

Enable Call Inspector

To enable Call Inspector, subscribe to an Agora Analytics pricing plan. For details, see Pricing Plans.

Use Call Search

On the Call Search page, you can apply multiple filters (including channel name, call duration, call freeze rates, and number of users) to search calls and view their basic information.

To search calls, follow these steps:

1. Log in to Agora Console and click Agora Analytics > Call Inspector on the left navigation menu.

2. In the upper-left corner, select a project. You see all the available calls^① under the project.

3. Start a search through one of the following ways:

   • Basic search: On the top of the page, select a time range, channel name or call ID, and call status.

   • Advanced search: Click Advanced in the upper right corner, add one or more filters as needed, and then click Search.

Get Call Overview

The Call Overview page is designed to help you quickly understand the overall situation of a large-scale call, so that you can locate problems or users and inspect user-specific issues. This page includes a summary of exceptions, as well as comprehensive metric statistics.

To enter the Call Overview page, follow these steps:

1. Subscribe to the Premium or Enterprise pricing plan. See Subscribe to a plan. Other pricing plans do not provide access to the Call Overview page.
2. Use Call Search to find the call you want to inspect, then click Call Details in the Action column.
   • If the number of Accumulated Call Users (ACU) is greater than or equal to 50, you enter the Call Overview page.
   • If the number of ACU is less than 50, you first enter the Call Details page. Click the Call Overview tab on the top to switch.

The Call Overview page consists of the following sections.

Exception summary

This section shows issues that might significantly affect user experience in the current call, including the following subsections:

	Description	Notes
Statistical insights	Important conclusions related to audio and video freezing.	If the number of ACU for the current call is less than 20 or no conclusion is available, this subsection is hidden. The data granularity of this subsection is one minute. If fewer than 20 (included) users are online during a given minute, the data point for this minute is ignored. In the upper right corner of this subsection, click the arrow icon to scroll to Detailed statistics.
Call experience (beta)	Significant user experience issues during the call. See Diagnosis checklist items.	Click on an issue to jump to the corresponding Call Diagnosis (Beta) page, where you can view the diagnosis conclusions of up to 10 users at the same time.
Host diagnosis (beta)	Issues encountered by hosts during the call. See Diagnosis checklist items.	Click on an issue to jump to the corresponding Call Diagnosis (Beta) page, where you can view the diagnosis conclusions of up to 10 users at the same time.
Abnormal host (beta)	Hosts who encounter streaming exceptions during the call, which are displayed along with their user IDs, streaming duration, and exception types.	If the Host diagnosis subsection shows no exception, this subsection is hidden. Click on an exception to jump to the corresponding Call Diagnosis (Beta) page, where you can view the diagnosis results for this host.

Detailed statistics

This section displays call quality statistics in a variety of charts to help monitor and analyze large-scale calls.

This section includes the following subsections:

View Call Details

The Call Details page helps you locate user-specific quality issues and exceptions.

The Call Details page consists of the following subpages:

• Homepage: The page you enter by clicking the Call Details tab on the top. On the homepage, you can get basic information about each user in the call. You can also view the key events and audio and video quality metrics for 20 users simultaneously.
• End-to-end details page: This page provides all of the key quality metrics and events for a single sender/receiver pair.
• Sender details page: This page provides all of the key quality metrics and events for a single sender.

For a detailed guide through each page, see Call Details Breakdown. For details on how to troubleshoot common call-quality issues, see Troubleshooting Manual.

View Call Diagnosis (Beta)

The Call Diagnosis page embeds Agora's auto-diagnosis engine to examine user experience issues and detect exceptions. The engine gives diagnosis conclusions based on a mapping between experience issues and possible causes. Currently, the engine is able to detect a number of call experience issues and host-specific issues. For details, see Diagnosis checklist items.

To view the Call Diagnosis page, follow these steps:

1. Use Call Search to find the call you want to inspect, then click Call Details in the Action column.
2. Click the Call Diagnosis (Beta) tab at the top of the page.
3. Add the following filters, as needed:
   • User: Enter the user ID to add users one by one, or use advanced search to add users in a batch. You can add up to 10 users for each diagnosis.
   • Time: Drag the slider, or select from the drop-down menu.
   • Exception: Select the exception type from the drop-down menu, such as sending issue, receiving issue, network issue, capturing issue, abnormal behavior, or user experience exception issue.
4. Click a user in the returned list to see the diagnosis conclusion:
   • If only one user ID is displayed, the conclusion is for the corresponding user.
   • If two user IDs are displayed, the conclusion is for the corresponding sender/receiver pair.
5. (Optional) Click View Details:
   • If the conclusion is for a single user and the user is a sender, you enter the sender details page.
   • If the conclusion is for a single user and the user is a receiver, you enter the call details homepage , and the switch for View metrics is turned on for the user.
   • If the conclusion is for a sender/receiver pair, you enter their end-to-end details page.

Give your feedback

All features related to the auto-diagnosis engine are currently in beta. Follow these steps to give us your feedback:

1. Hover your mouse over a diagnosis entry in any of the following places:
   • The Call Diagnosis page.
   • The Call experience (beta), Host diagnosis (beta), or Abnormal host (beta) subsection on the Call Overview page.
2. Hover your mouse over the highlighted text Is it accurate?.
3. Click Accurate diagnosis or Inaccurate diagnosis.
4. (Optional) Enter a detailed description in the text box.
5. Click Submit.

See also

• For a detailed explanation of the metrics and diagnosis checklist items used by Call Inspector, see Call Inspector Glossary.
• Alternatively, you can use the Call Inspector service through the RESTful API. For details, see Agora Analytics RESTful API.