How do I check on the queue workers?

Helix Swarm uses a custom queue system to process events, provide notifications, and more. The queue system is required to handle the potentially large volume of events from a busy Helix Versioning Engine.

Check the status of the queue by making an HTTP request to /queue/status. The response is formatted in JSON, and looks like this:

{"tasks":0,"futureTasks":1,"workers":3,"maxWorkers":3,"workerLifetime":"595s"}

This response indicates that the queue has no current tasks, there is 1 task scheduled for processing later, there are 3 queue workers available, at most 3 workers are created, and queue workers run for at most 10 minutes before self-terminating.

A queue manager ensures that sufficient queue workers are available to process items. If the queue manager has stopped for some reason, start a new one by making an HTTP request to /queue/worker. No response is provided for this request.

Note

A cron job should be setup to ensure that workers are running to process events. See Set up a recurring task to spawn workers.