# Call Inspector (/en/realtime-media/agora-analytics/build/explore-and-analyze-data/call-search)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

The Agora Analytics Call Inspector enables you to:

* Find a call or a group of calls.
* Determine the overall call quality in a channel.
* Dive into user-specific metrics and events.
* Examine user experience issues.

The following workflow shows how to use Call Inspector features:

![call-inspector](https://assets-docs.agora.io/images/analytics/call-inspector.svg)

<CalloutContainer type="info">
  <CalloutTitle>
    Enable Call Inspector
  </CalloutTitle>

  <CalloutDescription>
    To enable Call Inspector, subscribe to an Agora Analytics pricing plan. For details, see [Pricing](../../reference/pricing.md).
  </CalloutDescription>
</CalloutContainer>

## Use Call Search

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

![Call Search](https://assets-docs.agora.io/images/analytics/call-search.png)

To search calls, follow these steps:

1. Log in to [Agora Console](https://console.agora.io/v2) and click **Agora Analytics** > **Call Inspector** in 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 in 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**.

The accessible time range depends on the data retention policy for Call Inspector features in your [Pricing Plan](../../reference/pricing.md).

## 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](../../reference/pricing.md) to the Premium or Enterprise pricing plan. Other pricing plans do not provide access to the Call Overview page.
2. [Use Call Search](#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)](../../reference/call-search-terms.md) 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:

![Call Overview](https://assets-docs.agora.io/images/analytics/call-overview.png)

|                      | Description                                                | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Statistical insights | Important conclusions related to audio and video freezing. | * If the number of [ACU](../../reference/call-search-terms.md) 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](#detailed-statistics). |

### Detailed statistics

This section displays call quality statistics through various charts to help monitor and analyze large-scale calls.

![1650429301020](https://web-cdn.agora.io/docs-files/1650429301020)

![1650429365123](https://web-cdn.agora.io/docs-files/1650429365123)

This section includes the following subsections:

| Sub-section                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                                | Notes                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Time selector                                 | Select the time range you want to inspect.                                                                                                                                                                                                                                                                                                                                                                                 | If you change the time range, the data displayed in all of the following subsections is updated.                                                                                                                                                                                                                                                                       |
| Top video freezing users/Video freeze details | * If the number of [ACU](../../reference/call-search-terms.md) does not exceed 20 in the current call, this subsection is shown as **Top video freezing users**, ranking all users in the descending order of video freeze rate.
* If the number of ACU in the current call exceeds 20, this subsection is shown as **Video freeze details**, distributing users into different brackets based on their video freeze rate. | N/A                                                                                                                                                                                                                                                                                                                                                                    |
| TOP audio freezing users/Audio freeze details | - If the number of ACU does not exceed 20 in the current call, this subsection is shown as **Top audio freezing users**, ranking all users in the descending order of audio freeze rate.
- If the number of ACU in the current call exceeds 20, this subsection is shown as **Audio freeze details**, distributing users into different brackets based on their audio freeze rate.                                         | N/A                                                                                                                                                                                                                                                                                                                                                                    |
| Trend tracking                                | Relations between the following metrics and time:- Audio freezing users: The number of users whose audio freeze rate is greater than 3%.
- Video freezing users: The number of users whose video freeze rate is greater than 5%.
- Number of in-call users
- [Audio freeze rate](../../reference/call-search-terms.md)
- [Video freeze rate](../../reference/call-search-terms.md)                                         | * If the number of ACU in the current call does not exceed 20, this subsection is hidden.
* All the metrics displayed in the subsection are calculated by minute.
* The value of Peak Call Users to the left of the line chart is for reference only. The more precise metric is [Peak Concurrent Users](../../reference/call-search-terms.md) at the top of the page. |
| Metric Analysis                               | Distribution of audio freeze rate and video freeze rate by geography, device, network, SDK version, and operating system.                                                                                                                                                                                                                                                                                                  | If the number of ACU in the current call does not exceed 20, this subsection is hidden.                                                                                                                                                                                                                                                                                |

## View Call Details

The Call Details page helps you locate user-specific quality issues and exceptions. It 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 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 details on how to troubleshoot common call-quality issues, see [Troubleshooting](../../reference/call-search-manual.md).

### Homepage

To view the Call Details homepage, follow these steps:

1. [Use Call Search](#use-call-search) to find the call, then click **Call Details** in the **Action** column.

   * If the [ACU](../../reference/call-search-terms.md) is greater than or equal to 50, first enter the Call Overview page. Click the **Call Details** tab on the top to switch.

   * If the ACU is less than 50, you enter the Call Details homepage.

2. Add users through one of the following ways:

   * Add one by one: Enter the user ID, and click **Add User**.

   * Add in a batch: Click **Advanced search**, add one or more filters as needed, and then click **Search**. In the returned list, select the users you want to add, and click **Save**.

3. Display or hide the [audio and video quality metrics](#audio-and-video-quality-metrics) for the added users: Click the switch in the **View metrics** column. You can turn on the switch for a maximum of 20 users simultaneously.

4. Select the time range you want to inspect. If the time range changes, the audio and video quality metrics data is updated.

   ![1650430027822](https://web-cdn.agora.io/docs-files/1650430027822)

#### Key events

For each user with the **View metrics** switch enabled, this section displays their events within the selected time range in two views: Timeline and List

**Timeline view**

The circles on the timeline represent events. A larger circle means more events occurred at that time. If a noteworthy event occurred, the circle is marked red.

![1650430075044](https://web-cdn.agora.io/docs-files/1650430075044)

In the timeline view, you can do the following:

* Hover your mouse over a circle to view event logs.

* Click the zoom-in or zoom-out icon in the upper right corner to adjust the time scale.

* Select one or more event types using the drop-down menu in the upper right corner, including **login and logout**, **network transmission**, **video sending**, and **audio sending**.

* Click **List view** in the upper right corner to switch to the list view.

**List view**

The list view has three columns: Time, event type, and event. The list is displayed side by side with the corresponding user’s audio and video quality metrics.

![1650430094383](https://web-cdn.agora.io/docs-files/1650430094383)

In the list view, you can do the following:

* Select one or more event types using the drop-down menu in the upper right corner, including **login and logout**, **network transmission**, **video sending**, **video receiving**, **audio sending**, and **audio receiving**.

* Click **Timeline view** in the upper right corner to switch to the timeline view.

#### Audio and video quality metrics

With the core audio and video metrics displayed in the sender’s and receiver’s view, this section shows the quality of experience within the selected time range for each user whose **View metrics** switch is turned on (referred to as "selected users").

The metrics are defined in [User-specific metrics](../../reference/call-search-terms.md).

**Sender’s view**

Click **Sender’s view**, and choose **Audio** or **Video**. You can see the sending bitrates and upstream packet loss rates for all [senders](../../reference/call-search-terms.md) among the selected users.

Follow these steps to locate abnormal senders:

* If the line chart has many red glitches, the upstream packet loss rate might be high. Click **View sender details** in the upper right corner to enter the [sender details page](#sender-details-page) for further inspection.

* If an exclamation mark appears in the upper right corner, the user might encounter an issue that significantly affects the user experience. Click the exclamation mark to enter this user’s [Call diagnosis (Beta)](#view-call-diagnosis-beta) page.

**Receiver’s view**

Click **Receiver’s view**, and click **Audio** or **Video**. You can see the receiving bitrates and freeze time for all [receivers](../../reference/call-search-terms.md) among the selected users. If audio and video streams from multiple senders are received, they are marked in different colors on the line chart.

Follow these steps to locate abnormal receivers:

* If the line chart has many red glitches, the receiver might experience significant freezing issues. In the upper right corner of the line chart, click **Inspect a remote client**, and select the corresponding sender’s user ID from the drop-down menu. You enter the [end-to-end details page](#end-to-end-details-page) for further inspection.

* If an exclamation mark ![](https://assets-docs.agora.io/images/analytics/exclaimaition.png) appears in the upper right corner, the user might have encountered an issue that significantly affected the user experience. Click the exclamation mark to enter this user’s [Call diagnosis (Beta)](#view-call-diagnosis-beta) page.

### End-to-end details page

This page provides the following information for the selected sender-receiver pair:

* Call Diagnosis conclusions. If the selected receiver and sender do not encounter significant experience issues, this information is hidden.

* Quality metrics, including network status, device status, and audio and video quality. See [User-specific metrics](../../reference/call-search-terms.md).

* Key events, including a timeline view and a list view. In the list view, you can filter event types using the drop-down menu in the upper left corner.

![1650435338925](https://web-cdn.agora.io/docs-files/1650435338925)

### Sender details page

This page contains the following information for the selected sender:

* Call Diagnosis conclusions. If the selected sender does not encounter significant experience issues, this information is hidden.

* Quality metrics, including network status, device status, and audio and video quality. See [User-specific metrics](../../reference/call-search-terms.md).

* Key events, including a timeline view and a list view. You can filter event types using the drop-down menu in the upper right corner.

![1650435355537](https://web-cdn.agora.io/docs-files/1650435355537)

## 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](../../reference/call-search-terms.md).

![1650429448641](https://web-cdn.agora.io/docs-files/1650429448641)

To view the Call Diagnosis page, follow these steps:

1. [Use Call Search](#use-call-search) to find the call you want to inspect, then click **Call Details** in the **Action** column.
2. Click the &#x2A;*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](#sender-details-page).
   * If the conclusion is for a single user and the user is a receiver, you enter the [call details homepage ](#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](#end-to-end-details-page).

## Give your feedback

All features related to the auto-diagnosis engine are currently in beta. Follow these steps to send 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 &#x2A;*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](../../reference/call-search-terms.md).
* Alternatively, you can use the Call Inspector service through the RESTful API. For details, see [Agora Analytics RESTful API](/en/api-reference/api-ref/agora-analytics/analytics-rest-api).
