Skip to main content

Task Queues

Watch the background jobs that run behind the platform.

What Task Queues Shows​

Open Monitoring → Task Queues. The page lets you monitor the background task queues and their jobs. Work that does not need to happen while a person waits, such as running a workflow or syncing data from the telephone system, is placed in a queue and handled in the background. The example on this page is the workflow execution queue.

Task Queues page with a list of six queues, each with a progress bar and counts, and the detail of the workflow execution queue on the right

Figure 1. The Task Queues page, with the workflow execution queue selected and its states shown on the right.

The Queue List​

Each queue has a name, a status tick, a progress bar and a line of counts: pending, done and failed. A search box above the list finds a queue by name.

QueueWhat it handles
WORKFLOW-EXECUTIONRuns the steps of workflows, including their delays.
3CX-PASSWORD-RESET-EMAILSends the emails that reset a 3CX password.
CAMPAIGN-SCHEDULE-MANAGERStarts and stops campaigns at their scheduled times.
TCX-DATA-SYNCSynchronizes data from the telephone system.
TCX-HISTORY-SYNCSynchronizes call history from the telephone system.
RESOURCE-ACTIVATIONActivates resources such as users and extensions.

A Queue's Detail​

Click a queue to see its jobs by state. Eight cards show the count in each state, and a table below lists the jobs with their timestamp, ID and name.

StateMeaning
ACTIVEJobs being worked on now.
COMPLETEDJobs that finished.
DELAYEDJobs that are waiting for a set time before they run, such as the wait step of a workflow.
FAILEDJobs that stopped with an error.
PAUSEDJobs held because the queue is paused.
PRIORITIZEDJobs that were given priority over others.
WAITINGJobs ready to run, waiting for a free worker.
WAITING-CHILDRENJobs that wait for the smaller jobs they started.
info

A job in the DELAYED state is not stuck. It is waiting for its scheduled time, for example the delay step of a workflow, and it moves to ACTIVE when the time arrives.

Pause and Delete​

Two buttons sit at the top right of a queue's detail. Pause Queue stops workers from taking new jobs until you resume. Delete Queue removes the queue.

warning

Pausing a queue stops the work that depends on it. Pausing the workflow queue, for example, stops automations from running until it is resumed. Delete Queue removes the queue and its jobs, so use it only when you are sure the jobs are no longer needed.