# Studio Bellona Render Queue Management Troubleshooting

## Queue Backlog Spikes

Symptoms:

- Queue depth rises rapidly while throughput stays flat.
- Priority lanes are starved by background workloads.

Checks:

- Confirm scope and status filters isolate the blocked lane.
- Verify farm saturation and worker ceilings in diagnostics.
- Validate retry budget exhaustion for failing jobs.

Recovery:

- Apply queue triage saved view for blocked cinematic bursts.
- Reduce non-critical queue priority and reroute workers.
- Capture the action in audit trail and change history.

## Stream Reconnect Flapping

Symptoms:

- Stream reconnect count increases repeatedly within short windows.
- Lag oscillates between live and reconnecting states.

Checks:

- Confirm stream heartbeat freshness and recent event source.
- Inspect network and farm ownership changes in timeline events.
- Validate policy tier allows stream mutation controls.

Recovery:

- Run reconnect on the active queue and monitor lag deltas.
- Pause/resume stream only after recording baseline evidence.
- Escalate to render-ops if reconnect repeats beyond threshold.

## API Parity Drift

Symptoms:

- API parity report fails with unexpected or missing queue IDs.
- Imported payload diverges from baseline control set.

Checks:

- Export current state and compare against approved baseline.
- Validate import payload JSON structure and required fields.
- Confirm newly created queues are represented in parity contracts.

Recovery:

- Re-import sanitized baseline payload and rerun parity check.
- Remove drift entries only through policy-approved wizard/list paths.
- Record final parity result before release signoff.
