Files
peardata/user-guide/charts.md
T
Raven Scott c541c27ad8
CI / test (push) Successful in 1m17s
Release rolling / release (push) Successful in 8m15s
Prune work
2026-07-30 12:38:17 -04:00

68 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).