# Counter

A Counter displays a single numeric value as a large, prominent number. Use it to show current totals, capacity, or key metrics at a glance.

It’s ideal for:

* CPU cores
* Active users
* Total requests
* Memory size
* Node count
* License usage

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FkANQLqBHsJigNnRuFtAn%2FScreenshot%20from%202026-01-10%2008-28-10.png?alt=media&#x26;token=fe677a82-1712-47c7-a05b-6f3d5d48f69a" alt="Example Counter tile showing a large number with a unit label"><figcaption><p>Example Counter tile</p></figcaption></figure>

### Configure a Counter

Set **Chart type** to **Counter**. Set **Unit** to the label shown under the number.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2Fx49z2xXGSu22yHSuDdIN%2FScreenshot%20from%202026-01-10%2008-29-16.png?alt=media&#x26;token=159be54c-f02c-4cb2-9008-e8eb84d8bf86" alt="Counter chart settings showing the Unit field"><figcaption><p>Counter configuration</p></figcaption></figure>

### Counter configuration options

Use these options to control how the Counter renders.

| Option     | Purpose                               |
| ---------- | ------------------------------------- |
| Chart type | Must be **Counter**.                  |
| Unit       | Display label shown under the number. |

Common **Unit** values:

* `CPU Cores`
* `GB`
* `Requests`
* `Users`
* `Errors`
* `%`

{% hint style="info" %}
Key rules:

* Counter uses one numeric value.
* Unit is display-only.
* No grouping or time axis.
* Built for dashboard KPIs.
  {% endhint %}

### How the Counter value is chosen

The Counter displays the latest or aggregated value from your query result.

If the query returns multiple rows, the system uses:

* The latest time value, or
* An aggregated value (depends on the query)

### When to use a Counter

Use Counter when you want:

* One key number
* At-a-glance KPI display
* Capacity metrics

It’s perfect for CPU cores, total memory, active sessions, and running pods.
