Durabull Documentation

Workers Topology

Understand worker connectivity, queue assignments, and active/idle status from the workers view.

Route Scope

Workers route:

  • /$orgSlug/c/$connectionId/workers

This view combines topology visualization and worker detail table.

Topology Model

The graph renders nodes and edges for:

  • Redis node
  • Queue nodes
  • Worker nodes per queue

Queues and workers are sorted for stable layout. Edge styling reflects queue and worker activity.

Worker Status Rules

Durabull classifies workers as active/idle using the idle time reported by Redis client introspection. This is a connectivity heuristic, not proof that a worker is executing a job. Check the queue's active-job count and individual jobs to confirm processing.

API Endpoint

  • GET /api/c/:connectionId/workers

Returns:

  • worker list with queue context
  • queue rollups (worker count, pause status, active/waiting counts)
  • queue-level pagination metadata

Practical Use Cases

  • Verify worker registration after deployment changes.
  • Detect queues with waiting jobs but no workers.
  • Confirm whether queue pause state is intentional.