Docs/Reference/Troubleshooting matrix
CLIENT 0.4.3PYTHON 3.8+

Troubleshooting matrix

Symptom, likely cause, and fix in one place.

Diverges immediately → wrong measurement convention, stale response, or under-resolved readout → validate the integration with a bounded dry run.

Moves, then stalls → statistic noise or saturation → increase the batch slightly and tighten the operating range.

Works at small n, fails at scale → scalar bottleneck or stale corrections → preserve the per-channel measurement vector.

Hosted loop is too slow → network hop dominates → scope the offline build.

Need the answer on your plant?

Run the envelope, then race the runtime and your incumbent under the same measured budget.

Start evaluation