Skip to main content

Worker Health Check

GET 
/api/v1/health/worker

Check if the ARQ background worker is alive and processing jobs.

Checks:

  1. Worker heartbeat exists in Redis (arq:queue:health-check)
  2. Heartbeat is recent (TTL > 10 seconds means refreshed recently)
  3. Queue depth is reasonable (warns if > 100 pending jobs)

Returns:

  • 200: Worker is healthy
  • 503: Worker appears dead or unresponsive

Use this endpoint for external monitoring (UptimeRobot, etc.) to alert when background jobs stop processing.

Responses​

Successful Response