> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.

# View allocated pools

The **Metrics Quotas** page displays existing metrics pools, the
persisted writes quota allocated to each pool, and the amount of persisted writes
quota consumed by each pool.

Teams can use this information to:

* Understand which pools are consuming quota and how much.
* Identify which pools are at risk of being limited.
* Determine how each pool has prioritized its traffic to ensure that only lower
  priority data drops if the system exceeds its limit while a pool is over its quota.

Select from the following methods to view your metrics pools.

<Tabs>
  <Tab title="Web" id="view-pools-web">
    1. In the navigation menu, click **<Icon icon="shield-user" /> Go to Admin**
       and then select
       **<Icon icon="shapes" /> Control <span aria-label="and then">></span> Metrics Quotas**.
    2. Use the **Sort by** menu to change the display order. A summary of **All Pools**
       always display at the top of the list.
    3. Use the **Search** box to find a specific pool.
    4. Select a **Time Range** to display.
    5. Select a pool name to view data specific to that pool. The **Default Pool** is the
       pool containing all otherwise unassigned metrics.

    Hold the pointer over any sparkline chart to display a dialog with data specific to
    that day and time. Click the dialog to pin it.
  </Tab>

  <Tab title="Chronoctl" id="view-pools-chronoctl">
    To list your existing metrics pools using [Chronoctl](/tooling/chronoctl), use the
    `chronoctl resource-pools read` command:

    ```shell theme={null}
    chronoctl resource-pools read
    ```
  </Tab>

  <Tab title="API" id="view-pools-api">
    To complete this action with the Chronosphere API, use the
    [`ReadResourcePools`](/tooling/api-info/definition/operations/ReadResourcePools) endpoint.

    Because the Chronosphere API requires authentication, include an API token with your
    `curl` request, as shown in the following example. For more details, see
    [Create an API token](/tooling/api-info#create-an-api-token).

    ```shell /"TOKEN"/ /INSTANCE/ /METHOD/ /ENDPOINT_PATH/ theme={null}
    export CHRONOSPHERE_API_TOKEN="TOKEN"
    export CHRONOSPHERE_DOMAIN="INSTANCE.chronosphere.io"

    curl -H "API-Token: ${CHRONOSPHERE_API_TOKEN}" \
         -X METHOD "https://${CHRONOSPHERE_DOMAIN}/ENDPOINT_PATH"
    ```

    Replace the following:

    * *`TOKEN`*: Your API token.
    * *`INSTANCE`*: The subdomain name for your organization's Observability Platform instance.
    * *`METHOD`*: The HTTP method to use with the request, such as `GET` or `POST`.
    * *`ENDPOINT_PATH`*: The specific endpoint you want to access.
  </Tab>
</Tabs>

## All Pools

When viewing **All Pools**, you can see system-wide persisted writes quota
consumption and the pools consuming the highest percentage of their assigned quotas.

The upper portion of this page displays persisted writes statistics across all pools:

* **Limit** total for persisted writes, in data points per second (DPPS).
* **Average** persisted writes in DPPS.
* **Current** percentage of usage versus your limit.
* **Total over time** is a graph of the change over time in the overall consumption
  of quota, as a percentage of total quota.

The **All Pools** page includes additional charts and statistics:

* **Overall limit and consumption by pool** is a stacked-area sparkline chart of
  individual pools and how much quota they're consuming. Use this chart to compare
  pools and better understand which of them are using the most resources. Hold the
  pointer over the chart to view the number of data points contributed by each pool
  at that time.
* **Quota consumption by pool** graphs detail the assigned limits and current
  consumption of that limit for each pool. If one of your pools exceeds its limit,
  but the overall quota consumption is still 100%, the pool exceeding the limit
  continues to collect data normally. Hold the pointer over a graph to see incoming
  data points and the quota limit.

  When the system exceeds the persisted writes limit, Chronosphere Observability
  Platform enforces the limit by dropping data from pools over their quota.
* **License overage state** shows the volume of metrics dropped for each pool that's
  in a penalty state. Any pool that exceeds the persisted writes license capacity
  displays in this chart.

## Select a pool

Click a pool name to view data specific to that pool. The pool's page includes the
percentage of persisted writes the selected pool consumes, and overall quota
consumption against the total persisted writes limit.

Each pool page also includes the following details about the pool's quota usage:

* **Top persisted writes by service** can help determine which services configured in
  this pool generate the most writes.
* **Persisted writes trends by service** displays the current percentage of total
  quota this pool is using, and a graph tracking the usage of the time range.
* **Quota consumption** tracks the consumption of quota in DPPS, against the limit.
* **Traffic priority**: Displays traffic priority in a box chart that shows which
  priorities have the most traffic, based on
  [priority definitions](/control/shaping/shape-metrics/quotas/manage-pools).

In addition to any named metric pools you define, all instances have a
**Default pool**. You can set the quota for the default pool, but not the name or
match criteria. The default pool matches any metric that isn't matched by another
pool. New metrics that don't match defined pools get assigned to the
**Default pool**.

### License overage dropped metrics

If the aggregate usage exceeds the
[Persisted Writes Capacity limit](/administer/limits-licensing/concepts#persisted-writes), the pools
exceeding their defined quotas are penalized. In this penalty state, Observability
Platform can start dropping data points.

During a penalty period, the **License overage dropped metrics** pane displays the
total volume of dropped metrics for each pool, and the associated priority of high,
medium, and low. Use these graphs to identify when Observability Platform started
dropping metrics. You can then create [drop rules](/control/shaping/shape-metrics/rules/drop-rules)
to drop incoming metrics and create
[aggregation rules](/control/shaping/shape-metrics/reduce-cardinality/aggregation-rules) to reduce persisted writes.

### Quota Configuration Values

This table lists all the label **Values** matching the pool configuration. and how
much DPPS each contributes to the pool quota. In the **Default pool**, new metrics
have the **New** indicator.

### Quotas for the Histogram Metrics License

Observability Platform offers limited support of metric quotas for metrics that
consume [Histogram Metrics License](/administer/limits-licensing/concepts#histogram-metrics-license) capacity. The percentage
quota defined for a pool applies to both Standard and Histogram Metrics.

For example, when you allocate a 30% quota to a pool, the pool's quota is 30% of your
Standard Metrics License's persisted writes and 30% of your Histogram Metrics
License's persisted writes. However, the Metrics Quotas UI doesn't provide usage
information for the Histogram Metrics License's persisted writes.
