Debugging Playbook

​

Goal

​

Fast Triage Loop

1. Re-run Validate Stream.
2. Re-test condition with Check Once.
3. Inspect Get Job Details.
4. Map error code in the response payload.

​

Failure Patterns and Fixes

​

Stream validation fails

• NOT_LIVESTREAM
• STREAM_FETCH_FAILED
• STREAM_OFFLINE

• verify stream is currently live
• replace invalid/unreachable URLs
• retry after transient stream/network issues

​

Condition never triggers

• long-running jobs with no match

• rewrite condition with explicit visual criteria
• validate with check-once before restarting monitor jobs

​

Job creation rejected

• MAX_JOBS_REACHED

• list jobs: List Jobs
• cancel stale jobs: Cancel Job

​

Delivery mismatch

• expected SSE but got JSON
• expected webhook callbacks but none received

• ensure Accept: text/event-stream for SSE
• ensure webhook_url is valid HTTPS and publicly reachable
• confirm your handler returns 2xx promptly

​

Decision Checklist During Incidents

• Is the stream still live?
• Does check-once confirm condition wording?
• Is job status progressing?
• Is delivery mode configured as intended?

​

Next Steps

• Polling reliability patterns: Use Polling
• Webhook reliability patterns: Use Webhooks
• SSE client handling patterns: Use SSE Streaming