# 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="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FnpbMkjRFnBADhiMdqTJt%2FDownloadUsageReport.png?alt=media&#x26;token=eb32c943-fbe9-4e62-b0c2-88882b804666" 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="https://3378426797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSQCLFQ4bslJ-HYc8c3%2Fuploads%2FbXc2mIdW70aCcvanjK1B%2FUsageReport.png?alt=media&#x26;token=ab220604-2301-4774-9327-6a2c51cd053e" 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](https://docs.tonic.ai/app/admin/environment-variables-setting) `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.