Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Faccount-management%2Fpayment-and-billing%2Fdata-usage-settings-panel.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Faccount-management%2Fpayment-and-billing%2Fdata-usage-settings-panel.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

# Data Usage settings panel

The Data Usage settings panel is a slide-in panel on the [Data Usage](https://coralogix.com/docs/user-guides/account-management/payment-and-billing/data-usage.md) page that centralizes the settings controlling how you access and analyze your team's data usage. From one place you can:

* Enable or disable the [data usage metrics](https://coralogix.com/docs/user-guides/account-management/payment-and-billing/data-usage-metrics.md) pipeline that powers the Data Usage dashboards.
* Enable and open the [`dataplan.usage_events`](https://coralogix.com/docs/user-guides/data-layer/system_dataspace/dataplan-usage-events.md) system dataset, which stores aggregated usage events you can query with DataPrime.

## Open the panel[​](#open-the-panel "Direct link to Open the panel")

1. In the navigation bar, select **Settings**, then **Data Usage**.
2. In the Data Usage header, select **Settings**. The **Data Usage settings** panel slides in from the right.

## Configure an S3 bucket[​](#configure-an-s3-bucket "Direct link to Configure an S3 bucket")

Data Usage visibility relies on a configured S3 metrics bucket. If no bucket is configured, the panel shows a **Configure S3 bucket** warning and the metrics toggle is disabled.

To configure the bucket, select **Configure Bucket** in the warning. Coralogix takes you to the archiving providers page, where you can set up an [S3 archive](https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive.md) for metrics.

## Enable data usage metrics[​](#enable-data-usage-metrics "Direct link to Enable data usage metrics")

The **Enable metrics** section controls the [data usage metrics](https://coralogix.com/docs/user-guides/account-management/payment-and-billing/data-usage-metrics.md) pipeline that exposes usage as Prometheus metrics. When enabled, Coralogix produces the `cx_data_usage_units`, `cx_data_usage_bytes_total`, and `cx_data_plan_units_per_day` metrics for use in Custom Dashboards, alerts, and reports.

A badge next to the title shows **Enabled** or **Disabled**.

To enable metrics:

1. Make sure an S3 metrics bucket is configured.
2. In the **Enable metrics** row, toggle the control on.

The toggle is disabled if you lack the `data-usage` `manage` permission or no bucket is configured.

## Enable the `dataplan.usage_events` dataset[​](#enable-the-dataplanusage_events-dataset "Direct link to enable-the-dataplanusage_events-dataset")

The **data.usage.history** section controls ingestion into the [`dataplan.usage_events`](https://coralogix.com/docs/user-guides/data-layer/system_dataspace/dataplan-usage-events.md) system dataset. The **data.usage.history** setting in the panel enables the **`dataplan.usage_events`** system dataset, these refer to the same underlying data source. A badge shows **Active** when ingestion is enabled or **Disabled** otherwise.

The call to action next to the section changes based on the dataset status:

* **Enable data.usage.history**: shown when ingestion is disabled. Selecting it takes you to **Dataspace management**, where you can enable write access for `dataplan.usage_events`.
* **View dataset in Explore**: shown when ingestion is active. Selecting it opens Explore with a DataPrime query pre-loaded against the dataset.

Note

The dataset CTA is disabled until the S3 bucket is configured and the dataset status has loaded.

## Permissions[​](#permissions "Direct link to Permissions")

| Resource            | Description                            | System roles               | API presets |
| ------------------- | -------------------------------------- | -------------------------- | ----------- |
| `DATA-USAGE:MANAGE` | Enable and disable Data Usage Metrics. | Data Admin, Platform Admin | DataUsage   |
| `DATA-USAGE:READ`   | View Data Usage Metrics.               | Data Admin, Platform Admin | DataUsage   |

Note

Write access to the `dataplan.usage_events` system dataset is controlled separately via dataset access policy, not role-based permissions. See [Dataset management](https://coralogix.com/docs/user-guides/data-layer/dataset-management.md) for details.

## Related resources[​](#related-resources "Direct link to Related resources")

* [Data Usage](https://coralogix.com/docs/user-guides/account-management/payment-and-billing/data-usage.md)
* [Data Usage metrics](https://coralogix.com/docs/user-guides/account-management/payment-and-billing/data-usage-metrics.md)
* [`dataplan.usage_events` dataset](https://coralogix.com/docs/user-guides/data-layer/system_dataspace/dataplan-usage-events.md)
* [The system dataspace](https://coralogix.com/docs/user-guides/data-layer/system_dataspace.md)
* [Dataset management](https://coralogix.com/docs/user-guides/data-layer/dataset-management.md)