# Agent Pause Activity Report

The Agent Pause Activity report shows you, at a glance, when your queue agents step away from taking calls and when they return. It records each pause, the reason behind it, and how long the agent stayed paused. Use it to understand break patterns and to see how much time agents spend away from the queue. This page covers how to open the report and what each metric means.

## Open the report

1. Sign in to the Cloud Voice management portal and go to **Reports and Recordings > Call Reports**.
2. Open the **Default Reports** tab.

   ![Call Reports page with the Default Reports tab selected](/images/pbx/access-new-call-report.png)

   :::note
   Cloud Voice uses an updated call-detail-record (CDR) structure, introduced in firmware version 84.21.0.117, that presents call activity more clearly and with richer detail. Older records are removed over time according to your **CDR Auto Cleanup** setting. Until that cleanup completes, current and historical data live in two places: the **Default Reports** tab holds the newer data, and the **Call Reports (Legacy)** tab holds data recorded before the upgrade. The steps here cover the newer data on the **Default Reports** tab. To review older activity, open the **Call Reports (Legacy)** tab instead.
   :::

3. In the **Call Center Reports** pane, select **Agent Pause Activity**.
4. Set the filters for the report.

   ![Filter controls for the Agent Pause Activity report](/images/pbx/select-agent-pause-activity-report.png)

   1. In the **Time** field, choose the date range you want the report to cover.
   2. Narrow the results by queue, by agent, or by pause reason.

   The report refreshes to show only the entries that match your filters.

   ![Agent Pause Activity results showing pause and unpause entries](/images/pbx/agent-pause-activity.png)

## Adjust the columns (optional)

Tailor the table so the details you care about stay in view.

| Action | How to do it |
| --- | --- |
| Choose which columns appear | Select the column icon ![Column selector](/images/pbx/filter-report.png) and pick the columns to show. |
| Freeze a column | Select the handle ![Drag handle](/images/pbx/drag.png) next to a field, then drag it to **Left (Freeze Column)** or **Right (Freeze Column)**. |
| Reorder columns | Select the handle ![Drag handle](/images/pbx/drag.png) next to a field and drag it to the position you want. |

![Column selection panel for the report](/images/pbx/filter-report.png)

## Save or schedule the report (optional)

Once the report is set up the way you like, you can keep it for later or have it emailed automatically.

:::tip
Pause data lives in the CDRs that **CDR Auto Cleanup** eventually purges. If you need to keep pause history beyond that window, download the report or add it to **Scheduled Reports** so a copy is saved or emailed to you on a regular basis.
:::

**Add it to My Reports** for one-click access:

1. At the bottom of the page, select **Add to My Reports**.
2. Give the report a name you will recognize, and fine-tune the filters or metrics if needed.
3. Select **Save**.

**Add it to Scheduled Reports** to have Cloud Voice email it on a recurring basis:

1. At the bottom of the page, select **Add to Scheduled Reports**.
2. Fill in the delivery schedule and recipient settings, then save.

**Download it** for offline review or further analysis:

![Report download settings dialog](/images/pbx/report-download-setting.png)

1. (Optional) Select the settings icon ![Settings](/images/pbx/setting-button.png) to adjust how the file is exported, then save your changes:
   - **File Format**: the format of the downloaded file: **CSV**, **XLS**, **PDF**, or **HTML**.
   - **Duration Format**: how every duration field is shown: **Display in Second (s)** or **Display as HH:MM:SS**.
   - **Export Fields**: which fields are included: **All** or **Selected**.
2. Select **Download**.

## Report metrics

| Metric | What it shows |
| --- | --- |
| Pause | The date and time the agent switched to **Pause** status. |
| Pause Reason | The reason the agent gave for switching to **Pause** status. |
| Unpause | Either the date and time the agent returned to **Unpause** status, or a note that the agent changed the pause reason without resuming. |
| Total Pause Time | The time elapsed between the agent entering the current pause and moving to another status, resuming work or switching to a different pause reason. |
| Total Pauses | The number of times the agent paused, not counting changes to the pause reason. |