---
title: Data Usage settings panel
description: 'Configure Data Usage visibility: enable the metrics ingestion pipeline and the dataplan.usage_events system dataset from a single panel.'
url: https://coralogix.com/docs/user-guides/account-management/payment-and-billing/data-usage-settings-panel/
product: dataplans
feature: Data Usage
feature_id: data-usage
feature_identifier: dataplans/data-usage
last_updated: '2026-11-02'
---

# Data Usage settings panel

The Data Usage settings panel is a slide-in panel on the [Usage & Quota](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

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

[![The Data Usage Settings panel showing the Data Usage visibility section, the Enable metrics row with an Enabled badge and its toggle on, and the dataplan.usage\_events row with an Active badge and the View dataplan.usage\_events button](/docs/assets/images/data-usage-settings-panel-950c18c461a8662b62b335037ecb57a0.webp)](https://coralogix.com/docs/assets/images/data-usage-settings-panel-950c18c461a8662b62b335037ecb57a0.webp)

## 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

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

The **`dataplan.usage_events`** section controls ingestion into the [`dataplan.usage_events`](https://coralogix.com/docs/user-guides/data-layer/system_dataspace/dataplan-usage-events.md) system dataset, described in the panel as storing aggregated usage data across the team. 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 dataplan.usage\_events** appears when ingestion is disabled. Selecting it takes you to **Dataspace management**, where you can enable write access for `dataplan.usage_events`.
* **View dataplan.usage\_events** appears 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            | 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

* [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)