# Charts tab

The Charts tab is the **metrics wall**: every chart the agent catalogs, grouped by taxonomy, with one shared time window.

## Layout

| Region | Role |
|--------|------|
| **Toolbar** | Live/Pause, Force, Board, Correlate, Reset, time presets, **Filters** |
| **Filters panel** | Search, section TOC, Group, Sort — collapsed by default for a full-width wall |
| **Correlate bar** | Appears in Correlate mode — method, Find Correlations, Clear |
| **Related / MC panels** | Ranked lists above the wall |
| **Wall** | Scrollable cards (only this pane scrolls on Charts) |

## Filters menu

**Filters** toggles a left panel with chart search, section jump list, downsample **Group**, and dimension **Sort**.

- Closed by default so the wall uses the full width.  
- Press **`/`** to open Filters and focus search.  
- **Esc** closes Filters (after clearing Correlate / Related if those are open).  
- With Filters closed and an active search, a **Filtered: …** chip appears — click **×** to clear.  
- Open/closed state persists in desktop settings.

## Time controls

| Control | Meaning |
|---------|---------|
| **1m … 6h** | Shared window length (live edge when playing) |
| **Pause / Play** | Stop or resume live advance (`Space`) |
| **Reset** | Back to live 5m |
| **Group** | Downsample aggregation (inside Filters): average / min / max / sum |
| **thin-history** (preset style) | Advisory — buffered history may be shorter than the window |

Retention never hard-locks presets once an agent is connected; longer windows may look sparse until samples accumulate. Agent-side history length and disk prune live under **Settings → Data** (default warm keep **3 months**, **1 GiB** budget) — see [Settings](./settings.md).

## Containers section

Docker / cgroup cards group under **Containers** with human titles (`dozzle · CPU`) when the agent has Docker socket access. Details: [Containers](./containers.md).

## Gestures

| Gesture | Action |
|---------|--------|
| Scroll | Browse the wall (normal) |
| **Ctrl / ⌘ / Shift + scroll** | Zoom the shared window |
| Horizontal drag | Pan (pause + scrub history) — not in Correlate mode |
| **Correlate mode + drag** | Brush highlight band |
| Click chart title | Expand min/avg/max stats |
| ⇢ | [Related metrics](./related-metrics.md) |
| ★ / ☆ | Pin / unpin |
| Type button | Cycle line / area / stacked / bar / pie |
| Resize handle | Card height (double-click resets) |

## Board mode

**Board** shows **pinned charts only**. Pin with ☆, reorder by drag in the Pinned section, then toggle Board. Clear Board to return to the full wall.

## Force (wallboard)

**Force** keeps the wall live even when you would otherwise pause — useful for always-on displays.

## Correlate

See the full guide: [Metric Correlations](./metric-correlations.md).

Shortcut: **`c`** toggles Correlate mode; **Esc** clears correlation results (or Related).