Taurus > User Manual > K6

K6 Executor

Use the k6 executor to run Grafana Cloud k6 based test suites.

In order to launch the Grafana Cloud k6 executor, use a YAML config like in the following example:

Example:

execution:
- executor: k6
  concurrency: 10  # number of K6 workers
  hold-for: 1m     # execution duration
  iterations: 20   # number of iterations
  scenario:
    script: k6-test.js  # has to be a valid K6 script

{
    "execution": [
        {
            "executor": "k6",
            "concurrency": 10,
            "hold-for": "1m",
            "iterations": 20,
            "scenario": {
                "script": "k6-test.js"
            }
        }
    ]
}

Important: Provide a valid K6 script to run tests.

Script Example

This is an example of a valid script from the K6 website:

import http from 'k6/http';
import { sleep } from 'k6';
 
export default function () {
  http.get('https://blazedemo.com/');
  sleep(1);
}

Command-line Settings

You can specify special cli options for K6, for example:

modules:
  k6:
    cmdline: --out json=result.json

{
    "modules": {
        "k6": {
            "cmdline": "--out json=result.json"
        }
    }
}

On this page:

K6 Executor
- Script Example
- Command-line Settings

Quick Links: