Skip to content

Queues

Queues allow you to exchange values between virtual users. Unlike other types of variables:

  • Variables stored in the local memory of each virtual user,
  • Properties stored in the local memory of each load generator.

Queues exists outside of load generators and virtual users, allowing you to share values between any virtual user involved in your test.

Info

Queues have been added in OctoPerf 13.1. Before it was only possible through a third party queueing system.

Put

put

Name Description
Queue name Name of the queue to write into.
Value Value to write in the queue. Must be a single value, not a table.
Retries Number of retries before skipping.


Poll

poll

Name Description
Queue name Name of the queue to read from.
Variable name Name of the variable in which the value will be placed.
Retries Number of retries before skipping.


Warning

Polling a value will remove it from the queue. If you need to consistently use the same value, consider the property action instead.

Limitations

The total number of values inside a queue is limited to 5000.

Queues are tied to a test, meaning they only exist for the test duration.