| name | genswarms-metrics-use |
| description | Wire the Genswarms.Metrics counters object: fire-and-forget bumps from other objects, closed key allowlist, periodic flush to an injectable store. Use when adding operational counters to a swarm or debugging "bump ignored" (key not in allowlist) or counters resetting on restart (no store). |
Genswarms.Metrics — using the counters object
Wiring
%{name: :metrics, handler: Genswarms.Metrics, config: %{
flush_ms: 300_000,
store: MyApp.MetricsStore, # optional: add_metrics/1 + today_metrics/0
extra_keys: ["my_app_event"] # extends the closed baseline set (still closed)
}}
Bump from any connected object: {"action":"bump","key":"reply_sent","n":2}.
{"action":"status"} returns totals (boot session), pending, and today's
durable counters when a store is present.
The allowlist is the point
Keys are a CLOSED set — a prompt-injected agent must not be able to mint
unbounded keys (metric amplification). Extend via config extra_keys (a declared list — still a closed set), never by
loosening the check.
Gotchas
- Without
store: totals live for the boot session only (memory), flush is a
no-op — that's the documented dev mode, not a bug.
- Bumps are fire-and-forget by design: a metrics outage never blocks a sender.
