51 lines
2.3 KiB
Markdown
51 lines
2.3 KiB
Markdown
# Settings
|
|
|
|
Settings persist under `~/.config/peardata` (or `PEARDATA_HOME`) for desktop prefs. Agent storage policy is stored on the agent itself.
|
|
|
|
## Appearance
|
|
|
|
| Setting | Notes |
|
|
|---------|-------|
|
|
| **Theme** | Light / dark |
|
|
| **Accent / density / motion** | Visual prefs for the desktop shell |
|
|
|
|
## Charts / Overview
|
|
|
|
| Setting | Notes |
|
|
|---------|-------|
|
|
| **Overview spark depth** | Sample count when Charts has no overriding window |
|
|
| **Default spotlight chart** | Chart id for Overview explore (e.g. `system.io`) |
|
|
|
|
## Data Manager
|
|
|
|
Controls **agent-side** history so disks and RAM stay bounded. Requires an **admin** connection to the agent.
|
|
|
|
| Control | What it does |
|
|
|---------|----------------|
|
|
| **Usage cards** | Total data dir size, Corestore size, in-memory hot/warm points, warm HyperDB sample |
|
|
| **Hot memory** | 1s ring depth (15m → 24h presets or custom points) |
|
|
| **Warm memory** | Downsampled in-RAM ring + samples-per-bucket |
|
|
| **Disk history** | Auto-rotate by age (default **3 months**; also 1 day → forever, or custom days) |
|
|
| **Soft disk budget** | Corestore size target that triggers extra prune (default **1 GiB**; `0` / Unlimited = none) |
|
|
| **Max warm points** | Hard cap on stored warm samples (`0` = unlimited) |
|
|
| **Auto prune** | Scheduled prune interval (hours; default on) — also runs physical GC |
|
|
| **Dry-run / Prune now** | Preview deletes or prune + reclaim disk (`clearUnlinked` + compact) |
|
|
| **Save to agent** | Applies live + writes `retention.json` on the agent |
|
|
|
|
Default warm retention preset is **3 months** with a soft **1 GiB** corestore budget. Prune deletes expired warm points then runs Hyperbee `clearUnlinked` + Hypercore `compact` so disk is actually reclaimed. Env seeds (`PEARDATA_TIER*`, `PEARDATA_WARM_*`) only apply when no `retention.json` exists yet. See [CONFIGURATION.md](../docs/CONFIGURATION.md) and [STORAGE-HYPERDB.md](../docs/STORAGE-HYPERDB.md).
|
|
|
|
## Connections
|
|
|
|
| Setting | Notes |
|
|
|---------|-------|
|
|
| **Restore saved agents** | Auto-dial peers on launch |
|
|
| **Max reconnect attempts** | Cap for background dial retries |
|
|
|
|
## Notifications
|
|
|
|
Desktop notification toggles for alerts (when the runtime supports them).
|
|
|
|
## Reset
|
|
|
|
Clearing local desktop prefs does not delete agent data. Use **Data → Prune now** or tighten retention to reclaim warm history on the agent.
|