Swarm 2014.1: User Guide

How do I check on the queue workers?

Perforce 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 Perforce service.

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,"workers":3,"maxWorkers":3,"workerLifetime":"595s"}

This response indicates that the queue is empty, 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”.

0 matching pages