System resource metrics

MINARA_SYSTEM_METRICS_DISABLED

What it controls: whether the gateway samples process + system resource usage (CPU, memory, disk free, sandbox folder size, network throughput, token throughput) and exposes the /v1/system-metrics endpoint with live data. The endpoint stays registered either way; when disabled it returns { disabled: true } and the web UI hides the row.
Consumed by: src/metrics/index.ts start().
When to set: resource-constrained operator hosts, test runs, or any environment where the 5s sampling tick + sandbox directory walk should not run.
Default: empty (collector enabled).
Format: 1 to disable. Anything else (including unset) leaves the collector enabled.
MINARA_SYSTEM_METRICS_DISABLED=1
Setting home: Not a user-facing setting

SYSTEM_METRICS_TOKEN_SESSION_WINDOW

What it controls: how many of the most recently active chat sessions feed the "Tokens/sec" headline figure. The collector keeps per-session aggregates of input/output tokens + wall-clock duration; on each snapshot the top-N most-recently active sessions are averaged together so an idle agent's number reflects current performance, not a lifetime average diluted by old idle sessions.
Consumed by: src/metrics/token-collector.ts snapshot().
When to set: lower (e.g. 3) for a tighter "right now" reading; higher (e.g. 10) for a smoother number that's less reactive to single-session outliers.
Default: 5.
Format: positive integer.
SYSTEM_METRICS_TOKEN_SESSION_WINDOW=5
Setting home: Not a user-facing setting