# Usage

## Overview

To access your **Usage** settings, click your user icon in the bottom left of the application and select **Usage**.

<figure><picture><source srcset="/files/SWyHsr8WZ6nW0JSBGEMc" media="(prefers-color-scheme: dark)"><img src="/files/rzZRcnqp38krJAzFHs3e" alt=""></picture><figcaption></figcaption></figure>

This view shows a detailed overview of the data usage across your Tenant.

<figure><picture><source srcset="/files/MthPiXFGLNDJ0c9aM64z" media="(prefers-color-scheme: dark)"><img src="/files/BjSNe84kMbzHnn6Mo13k" alt=""></picture><figcaption></figcaption></figure>

Use this view to analyze the flow of data and the change from stage to stage of the process. Here you can locate the most important contributions to your Tenant at a glance.&#x20;

{% hint style="info" %}
All data shown is analyzed compared to the previously selected time range. Use the time range selector at the top of this area to specify the periods to examine.

For example, if the time range were **yesterday** (the default period), the calculation of differences will be carried out using the previous **day** before the current selection

To learn more about time ranges, go to [Selecting a Time Range.](/getting-started/understanding-the-essentials/the-time-range-selector.md)
{% endhint %}

## Metrics

The **Usage** view shows various infographics that provide insights into your data flow. Some Listeners or Data Sinks may be excluded from these metrics if they are duplicates or reused.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Net Saved/Increased</strong></td><td>Here you can see the difference (in %) of volume <em>saved/increased</em> in comparison to the previous period. Hover the circle icons to see the input/output volumes and see the total GB saved.</td><td></td><td><a href="/files/72oTdAUUZAIB1ekX8g24">/files/72oTdAUUZAIB1ekX8g24</a></td></tr><tr><td><strong>Ingested</strong></td><td>View the total amount of data ingested by the Listeners in the selected time range compared to the previous, as well as the increased/decreased volume (in %).</td><td></td><td><a href="/files/XrWXuNmkgO8x2pcZu0Bt">/files/XrWXuNmkgO8x2pcZu0Bt</a></td></tr><tr><td><strong>Egressed</strong></td><td>You can see at a glance the total amount of data sent out of your Tenant, as well as the difference (in %) with the previous time range selected.</td><td></td><td><a href="/files/mAhgIaN6UbcPkIr6wZAa">/files/mAhgIaN6UbcPkIr6wZAa</a></td></tr><tr><td><strong>Daily average</strong></td><td>This shows the average volume of ingested data per day. You can also see the difference (in %) with the previous time range selected.</td><td></td><td><a href="/files/63tSXTvttRKMvz6rkQh1">/files/63tSXTvttRKMvz6rkQh1</a></td></tr></tbody></table>

## View usage

<figure><picture><source srcset="/files/m21gq8thmDulRSOSsVzR" media="(prefers-color-scheme: dark)"><img src="/files/YYxIR1ZmC5x2qEk8aRSK" alt=""></picture><figcaption></figcaption></figure>

* The graph at the top plots the data volume going through your Tenant. The purple line graph represents the bytes ingested, and the blue one represents the bytes egressed. Use the **Frequency** slider bar to choose how frequently you want to plot the bytes in the chart.
* At the bottom, you will find a list of all the Listeners and Sinks in your tenant, including all the events ingested in bytes and incoming events, egressed in bytes and outgoing.&#x20;

{% hint style="info" %}
The units used to measure the events in and out are in accordance with the [Metric Prefix](https://en.wikipedia.org/wiki/Metric_prefix) system.
{% endhint %}

<figure><img src="/files/cgIMQEdWLqiSKmKaSzrE" alt=""><figcaption></figcaption></figure>

### Avoid overload

Depending on the type of Onum plan you are using, there may be instances where your ingest limit is exceeded.&#x20;

To keep track before this happens, you will be visually reminded when an ingestion has exceeded the daily limit.

<figure><img src="/files/UKvxV8O1Yd18SPrrDKom" alt=""><figcaption></figcaption></figure>

There may be instanced where you were not able to keep the ingestion down, and thus the limit for the entire Tenant may be exceeded.&#x20;

<figure><img src="/files/xI2B9RA90q9kygcfT7WZ" alt=""><figcaption></figcaption></figure>


---

# 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.onum.com/administration/global-settings/tenant/usage.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.
