# Barrace

A bar race chart animates ranked bars across time frames. Use it to show how top categories change over time.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FNnCLP6Kul8GRahJm0MlW%2FScreenshot%20from%202026-01-09%2017-36-17.png?alt=media&#x26;token=e5860223-12f4-4b2a-95e5-d9f60e0d4bfd" alt=""><figcaption><p>Bar race chart</p></figcaption></figure>

### Configure a bar race chart

Use the **Plot** panel to choose axes, grouping, and display settings.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FUPE9osMDhXc6EswPa2tm%2FScreenshot%20from%202026-01-09%2017-37-15.png?alt=media&#x26;token=5e98dc73-5cf3-47f4-9a62-a55c8fc18e2d" alt=""><figcaption></figcaption></figure>

### Bar race chart options

Use these options to control how the bar race chart renders.

| Option       | What it controls                           | Typical values / notes                                                                                                   |
| ------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Value column | Numeric metric that determines bar length. | Examples: `value`, `memory_kb`, `cpu_usage`, `bytes_sent`. This column must be numeric.                                  |
| Label column | What each bar represents (entity name).    | Common choices: `pod`, `host`, `process`, `disk`. This column is used to name each bar and track entities across frames. |
| Unit         | Suffix appended to the displayed value.    | Examples: `kB`, `MB`, `ms`, `%`, `ops`.                                                                                  |
| Apply        | Applies changes to the widget.             | Changes do not render until you click **Apply**.                                                                         |

### When to use a bar race chart

Use a bar race chart when you want to:

* Show how rankings change over time (top N moving up/down)
* Highlight “winners” and “losers” across time frames
* Tell a story about change, not just a final snapshot

Typical use cases:

* Top services by request volume over time
* Top namespaces by log ingest over time
* Top hosts by CPU usage over time
* Top teams by cost over time

### When not to use a bar race chart

Avoid a bar race chart when:

* You need precise value comparisons (use Bar/Table)
* You have too many categories (animation becomes noisy)
* You want a continuous time series trend (use Line/Area)
* You need record-level inspection (use Table/List/Details)
