# Downloading the usage report

{% hint style="info" %}
**Required global permission:** View summary usage metrics
{% endhint %}

The usage report summarizes the number of table rows and cells that data generation jobs applied generators to.

{% hint style="info" %}
The usage report was introduced in V876. The report does not include jobs that ran before V876 was released.
{% endhint %}

## Selecting the download option for the usage report <a href="#usage-report-download" id="usage-report-download"></a>

To download the report, on **Structural Settings** view, click **Download Usage Report**.

<figure><img src="/files/hfZfEPzUMHuRk1HP4Hxe" alt=""><figcaption><p>Download Usage Report button on Structural Settings view</p></figcaption></figure>

The report is downloaded as **usage\_report.csv**.

## Information in the usage report <a href="#usage-report-columns" id="usage-report-columns"></a>

Each entry in the report represents a table that was processed by a data generation job.

<figure><img src="/files/S3ohb2YCA6kTKAb6QITj" alt=""><figcaption><p>Usage report</p></figcaption></figure>

The report contains the following columns:

* **Date** - The date and time when the data generation job completed.
* **WorkspaceName** - The name of the Tonic Structural workspace.
* **WorkspaceId** - The identifier of the Structural workspace.
* **JobId** - The identifier of the data generation job.
* **TableMode** - How the table was processed.
  * **PassThrough** - None of the columns had assigned generators.
  * **Masked** - The data generation job applied generators to table columns.
  * **Truncated** - The table mode was Truncate. No generators were applied.
* **TableName** - The name of the table.
* **RowCount** - The number of rows in the table that were processed. Indicates that generators were applied or that the rows were included in a subset.
* **CellCount** - The number of processed rows multiplied by the total number of columns in the table.

## Limiting the number of rows in the usage report <a href="#usage-report-row-limit" id="usage-report-row-limit"></a>

The [environment setting](/app/admin/environment-variables-setting.md) `USAGE_ROWS_COUNT_LIMIT` determines the maximum number of rows to include in the report. When the number of rows exceeds this limit, Structural removes rows from the oldest jobs one job at a time until the number of rows is within the limit.

To determine the value, use the following formula:

&#x20;`<number of days> * <number of jobs per day> * <number of tables>`

The default value is 450,000. This value was calculated based on 90 days with 5 jobs per day that each process 1000 tables.


---

# 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.tonic.ai/app/admin/tonic-monitoring-logging/tonic-data-usage-report.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.