1. Home
  2. Docs
  3. Operations & troubleshooting
  4. Queue and worker troubleshooting
Operations & troubleshooting

Queue and worker troubleshooting

Diagnose stuck Horizon jobs, excessive retries, report timeouts, and worker memory problems.

Developer v2026.10 Updated 9 Nov 2026

Check first

Review queue depth, failed jobs, current Horizon supervisors, job runtime, retry count, Redis health, database latency, and available memory.

Long-running reports

Large XLSForm, export, maintenance, or presentation jobs have longer timeouts than normal jobs. Make sure retry_after exceeds the worker timeout so the same job is not duplicated while the first copy is still running.

After deployment

Terminate Horizon so it restarts with the new application code. In containers, confirm the Horizon service is actually updated and not still running an older image.

Was this page helpful?

Still stuck?

Open a ticket and reference this page — we will pick it up from there.

Open a ticket