Per VU iterations

Description

Each VU executes an exact number of iterations. The total number of completed iterations will be vus * iterations.

Options

In addition to the common configuration options this executor also adds the following options:

When to use

Use this executor if you need a specific amount of VUs to complete the same amount of iterations. This can be useful when you have fixed sets of test data that you want to partition between VUs.

Example

In this example, we'll let 10 VUs execute 20 iterations each, for a total of 200 iterations, with a maximum duration of 30 seconds.

1import http from 'k6/http';
2import { sleep } from 'k6';
3
4export const options = {
5  discardResponseBodies: true,
6  scenarios: {
7    contacts: {
8      executor: 'per-vu-iterations',
9      vus: 10,
10      iterations: 20,
11      maxDuration: '30s',
12    },
13  },
14};
15
16export default function () {
17  http.get('https://test.k6.io/contacts.php');
18  // We're injecting a processing pause for illustrative purposes only!
19  // Each iteration will be ~515ms, therefore ~2 iterations/second per VU maximum throughput.
20  sleep(0.5);
21}

Observations

The following graph depicts the performance of the example script:

Based upon our test scenario inputs and results:

• The number of VUs is fixed at 10, and are initialized before the test begins;
• total iterations are fixed at 20 iterations per VU, i.e. 200 iterations, 10 VUs * 20 iters each;
• each iteration of the default function is expected to be roughly 515ms, or ~2/s;
• maximum throughput (highest efficiency) is therefore expected to be ~20 iters/s, 2 iters/s * 10 VUs;
• we then see that the maximum throughput is reached, but not maintained;
• because distribution of iterations is even amongst VUs, a fast VU may finish early and be idle for the remainder of the test, thereby lowering efficiency;
• total duration of 9 seconds is slightly longer than shared iterations due to lower efficiency;
• overall test duration lasts as long as the slowest VU takes to complete 20 requests.