No results for

Powered byAlgolia

What we talk about when we talk about k6.

In discussion about k6, some terms have a precise, technical meaning. If a certain term in these docs confuses you, consult this list for a definition.

Application performance monitoring
(Or APM). The practice of monitoring the performance, availability, and reliability of a system. You can export k6 OSS and k6 Cloud results to an APM to analyze system metrics alongside k6 metrics.

k6 OSS APM integrations, k6 Cloud APM integrations
Concurrent sessions
The number of simultaneous VU requests in a test run.
Checks
Checks are true/false conditions that evaluate the content of some value in the JavaScript runtime.

Checks reference
Data correlation
The process of taking dynamic data received from the system under test and reusing the data in a subsequent request.

Correlation and dynamic data example, Correlation in testing APIs
Data parameterization
The process of turning test values into reusable parameters, e.g. through variables and shared arrays.

Data parameterization examples
Dynamic data
Data that might change or will change during test runs or across test runs. Common examples are order IDs, session tokens, or timestamps.

Correlation and dynamic data example
Endurance testing
A synonym for soak testing.
Goja
A JavaScript engine written in Go. k6 binaries are embedded with Goja, enabling test scripting in JavaScript.

Goja repository
Graceful stop
A period that lets VUs finish an iteration at the end of a load test. Graceful stops prevent abrupt halts in execution.

Graceful stop reference
HTTP archive
(Or HAR file). A file containing logs of browser interactions with the system under test. All included transactions are stored as JSON-formatted text. You can use these archives to generate test scripts (for example, with the har-to-k6 Converter).

HAR 1.2 Specification, HAR converter
Iteration
A single run in the execution of the default function, or scenario exec function. You can set iterations across all VUs, or per VU.

The test life cycle document breaks down each stage of a k6 script, including iterations in VU code.
k6 Cloud
The proper name for the entire cloud product, comprising both k6 Cloud Execution and k6 Cloud Test Results.

k6 Cloud docs
k6 options
Values that configure a k6 test run. You can set options with command-line flags, environment variables, and in the script.

k6 Options
Load test
A test that assesses the performance of the system under test in terms of concurrent users or requests per second.

Load Testing
Load zone
The geographical instance from which a test runs.

Private load zones, Declare load zones from the CLI
Metric
A measure of how the system performs during a test run. http_req_duration is an example of a built-in k6 metric. Besides built-ins, you can also create custom metrics.

Metrics
Metric sample
A single value for a metric in a test run. For example, the value of http_req_duration from a single VU request.
Reliability
The probability that a system under test performs as intended.
Requests per second
The rate at which a test sends requests to the system under test.
Saturation
A condition when a system's reaches full resource utilization and can handle no additional request.
Scenario
An object in a test script that makes in-depth configurations to how VUs and iterations are scheduled. With scenarios, your test runs can model diverse traffic patterns.

Scenarios reference
Scenario executor
An property of a scenario that configures VU behavior.
You can use executors to configure whether to designate iterations as shared between VUs or to run per VU, or to configure or whether the VU concurrency is constant or changing.

Executor reference
Smoke test
A regular load test configured for minimum load. Smoke tests verify that the script has no errors and that the system under test can handle a minimal amount of load.

Smoke Testing
Soak test
A test that tries to uncover performance and reliability issues stemming from a system being under pressure for an extended duration.

Soak Testing
Stability
A system under test’s ability to withstand failures and errors.
Stress test
A test that assess the availability and stability of the system under heavy load.

Stress Testing
System under test
The software that the load test tests. This could be an API, a website, infrastructure, or any combination of these.
Test run
An individual execution of a test script over all configured iterations.

Running k6
Test concurrency
In k6 Cloud, the number of tests running at the same time.
Test duration
The length of time that a test runs. When duration is set as an option, VU code runs for as many iterations as possible in the length of time specified.

Duration option reference
Test script
The actual code that defines how the test behaves and what requests it makes, along with all (or at least most) configuration needed to run the test.

Single Request example.
Threshold
A pass/fail criteria that evaluates whether a metric reaches a certain value. Testers often use thresholds to codify SLOs.

Threshold reference
Throughput
The rate of successful message delivery. In k6, throughput is measured in requests per second.
Virtual user
(Or VU). The simulated users that run separate and concurrent iterations of your test script.

The VU option