# Real-time Monitor

{% hint style="info" %}
Manager Tools -> Real-time Monitor.

Access to this tool requires the **Service Operator, Agent,** or **Power Agent** roles.
{% endhint %}

The Real-time Monitor tool enables agents and managers to monitor various performance indicators and metrics in near real-time.

## User Roles and Access

* **Service Operator** Role: Users can utilize the organization tree to select the organization or a specific unit for monitoring.
* **Agents** and **Power Agent** Roles: Users can view data only for their current unit.

## Dashboard Overview

Upon selecting a unit, the In-focus tab displays a dashboard of widgets. Each widget shows various metrics and a chart depicting the progression of the main metrics from the beginning of the day.

The dashboard updates automatically every 5 minutes or when new metrics become available, ensuring users have the most up-to-date information.

<figure><img src="/files/5F6nL0p2Eiu6oqfmFn2O" alt=""><figcaption></figcaption></figure>

## Dashboard Customization

### Choosing Widgets

To choose the widgets to show and control their order, click the Widgets button (<img src="/files/MzIEwAdBTc3eR37uko6d" alt="" data-size="line"> ) to open the Widgets dialog:

<div align="left"><figure><img src="/files/GGFyhWVmSR1BpQAtbpIM" alt="" width="188"><figcaption><p>The Widgets dialog</p></figcaption></figure></div>

Choose widgets from the dropdown menu to add them to the view. You can rearrange the appearance order of the widgets by dragging them with your mouse.

For detailed information about the available widgets, see:

{% content-ref url="/spaces/8vfRpZGqpk7N0egaXMQ8/pages/yRK4t78TuLrD5xWITVku" %}
[Widgets Reference](/guides/user-tools/real-time-monitor/widgets-reference.md)
{% endcontent-ref %}

### Charts Time Range and Reference Data

To limit the charts to a specific time range or choose a reference date, click the Settings button (<img src="/files/aNdHDr4Ye1JEwaPnuZKJ" alt="" data-size="line">) to open the Settings dialog:

<div align="left"><figure><img src="/files/AEkJauY0YBbGmsKLlqRQ" alt="" width="188"><figcaption><p>The Settings dialog</p></figcaption></figure></div>

### **Reference Data**

Selecting a reference date allows you to compare today’s metrics to those of a past date.&#x20;

By ticking the Show Reference Data checkbox, a line representing data from the selected reference date will be added to each of the dashboard charts. This feature enables you to compare today’s progression to that of the chosen date and to anticipate future trends.

Usually, you’d compare today’s data to the previous workday. However, it can sometimes be useful to compare it to other dates. For example, if you know that certain days of the week exhibit different behavior (e.g., weekends), you can compare today to the same day in the previous week to better anticipate future behavior.

## Aggregating Data from Child Units

When you select a unit, the real-time monitor displays metrics calculated specifically for that unit.&#x20;

However, if the unit contains sub-units (e.g., the unit represents a region), you have the option to display aggregated metrics that include both the unit and its sub-units.

To enable this, turn on the **Include Child Units** switch. When this switch is activated, all data displayed on the dashboard will be aggregated from the selected unit and its descendant units.

<figure><img src="/files/jWZB1K6Ctbmg5fli0sLu" alt=""><figcaption><p>The Include Child Units switch</p></figcaption></figure>

## Unit Breakdown

Viewing aggregated metrics is useful when you are responsible for multiple units. However, the Unit Breakdown view becomes handy when you need to understand the source of a specific value.

This view displays all sub-units under the selected unit or organization, showing non-aggregated metrics for each selected metric. This allows you to pinpoint where specific values originate within the hierarchy.

<figure><img src="/files/16IgUC07SSClw2Gh5p2k" alt=""><figcaption><p>The Unit Breakdown tab</p></figcaption></figure>

### Choosing Columns

To choose the columns to show, click on the Columns button (<img src="/files/MzIEwAdBTc3eR37uko6d" alt="" data-size="line"> ) to open the Columns dialog:

<div align="left"><figure><img src="/files/pBXZKru7w6JszpSfzshE" alt="" width="188"><figcaption></figcaption></figure></div>

&#x20;Choose metrics from the dropdown menu to add them to the view. You can rearrange the appearance order of the metrics by dragging them with your mouse.

For detailed information about the available metrics, see:

{% content-ref url="/spaces/8vfRpZGqpk7N0egaXMQ8/pages/4M8KAg9BqGe9U2daKlaV" %}
[Metrics Reference](/guides/user-tools/real-time-monitor/metrics-reference.md)
{% endcontent-ref %}

## Viewing Active Alerts

The real-time monitor displays active alerts for the organizational units. The badge next to the unit name indicates the number of active alerts, and the badge's color represents the highest alert severity.\
\
You can use the Alerts tab to view the active alerts in the selected unit.

<figure><img src="/files/JxVSG7kThMrxsIQLyKIy" alt=""><figcaption><p>Real-time Monitor/ Alrts Tab</p></figcaption></figure>

To learn more about alerts, see:

{% content-ref url="/spaces/8vfRpZGqpk7N0egaXMQ8/pages/F3h6z2MmHC7kluYnm82L" %}
[Service Level Alerts](/guides/understanding-the-basics/service-level-alerts.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cubu.com/guides/user-tools/real-time-monitor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
