# 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/index.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/index.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/index.md) system dataset, which stores aggregated usage events you can query with DataPrime.

## Open the panel

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

## 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/index.md) for metrics.

## 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/index.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.
1. 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

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/index.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

| Resource           | Action       | Description                                                                          |
| ------------------ | ------------ | ------------------------------------------------------------------------------------ |
| `data-usage`       | `manage`     | Toggle metrics ingestion from the panel.                                             |
| `data-usage`       | `read`       | Open the Data Usage page and the settings panel.                                     |
| Dataset management | Write access | Enable write access on `dataplan.usage_events` from the dataspace management screen. |

## Related resources

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