Capture traces
Nano can record every instance's inputs so runs can be replayed and analysed
later. With the c8ctl plugin, add --capture when you start:
c8ctl nano start 3 --capture
c8ctl nano status # shows "trace capture: on"
Read a trace back from any node:
GET /console/api/traces/{instanceKey}
→ { creationVariables, stimuli[], <per-incident variables> }
Under the hood --capture sets NANOBPMN_TRACE_STIMULI=1 on every node, which
records the inputs needed for deterministic replay. The capture limits are
adjustable:
| Variable | Default | Purpose |
|---|---|---|
NANOBPMN_TRACE_STIMULI=1 |
off | Enable recorded-input replay capture. |
NANOBPMN_TRACE_VARIABLES_MAX_BYTES |
16384 | Max captured variable payload bytes. |
NANOBPMN_TRACE_STIMULI_MAX |
1024 | Max recorded inputs per instance. |
NANOBPMN_TRACE_CAPACITY |
2000 | Max traced instances retained. |