Processing Queues

Processing Queues show tasks that TAS, when scaled to multiple servers, does not process immediately but places in a queue, where worker processes (workers) handle them one by one. The page is available to administrators. Open it from the Administration menu using the Processing Queues tab in the Monitoring and Maintenance category. The tab is available only when queues are enabled in the installation.

The screenshot shows the tab in an installation that does not use queues.

When the page is available

Configuration keyWhat it enables
system.scaling.queueWorkflowThe Workflow queue. It handles, for example, case archiving and data changes made in Service Operations.
system.scaling.queueRightsThe Rights queue, which recalculates superiors' rights after a change to the organizational structure.

Both options are disabled by default. Until you enable at least one of them, the tab in the menu is greyed out and shows a tooltip when you hover over the question mark. The tooltip refers to the options by their older names scaling.queue.workflow.enabled and scaling.queue.rights.enabled, which are converted to the keys in the table during an upgrade.

What the page shows

On the left is the queue tree. For each enabled queue (Workflow, Rights), it lists the task states with the number of tasks in brackets:

StateMeaning
ActiveThe task is currently being processed.
CompletedThe task finished successfully.
DelayedThe task is waiting for a delayed start.
FailedThe task ended with an error.
PausedThe task is in a queue whose processing is paused.
RepeatRecurring tasks. No count is shown for this state.
Wait, WaitingThe task is waiting for a free worker to pick it up.
Waiting childrenThe task is waiting for its dependent subtasks to finish.

On the right is a table of tasks in the selected state with the columns ID, Name, Date (when the task was created), Data (the task's input data), Value (the result), Attempts made (number of attempts), Delay, Progress and Stacktrace (the error of a failed task). For the Completed state, the columns Job duration (processing time) and Total duration (time from task creation to completion) are added.

Buttons

ButtonPurpose
DetailOpens all details of the selected task, including the times it was created, processed and completed. Double-clicking a row does the same.
DeleteAfter confirmation, removes the selected task from the queue. The Delete key works as well.
To completedActive state only. Moves the task to completed tasks.
To delayedActive state only. Delays the task until the specified date.
To failedActive state only. Moves the task to failed tasks.
RefreshReloads the tree and the table.
WorkersOpens the list of workers for the selected queue, with Resume and Pause buttons to resume and pause processing.
CloseReturns you to the Administration menu.
Intervening in queues
If you delete a task or move it manually, the operation (for example, archiving a case or recalculating rights) is not performed, or is only partly performed. Pausing workers stops processing of the entire queue. Intervene in queues only when troubleshooting a problem.

Related: System Status, Service Operations, Configuration, Administration Menu

Scheduled Tasks

Maintenance
Syca (opens in a new tab)

Powered by HelpDocs (opens in a new tab)