Menu

This is documentation for the next version of K6. For the latest stable release, go to the latest version.

Open source

HTTP

A HTTP Fault describes the characteristics of the faults to be injected in the HTTP requests served by a target.

A HTTP fault is described by the following attributes:

AttributeTypeDescription
averageDelaystringaverage delay added to requests represented as a string (default 0)
delayVariationstringvariation in the injected delay (default 0)
errorBodystringbody to be returned when an error is injected
errorCodenumbererror code to return
errorRatenumberrate of requests that will return an error, represented as a float in the range 0.0 to 1.0 (default 0.0)
excludestringcomma-separated list of urls to be excluded from disruption (e.g. /health)
portnumberport on which the requests will be intercepted

Note

averageDelay and delayVariation are applied to all requests affected by the fault, regardless of the value of errorRate. errorCode is returned only to a fraction of requests defined by errorRate.

Example

This example defines a HTTP fault that introduces a delay of 50ms in all requests and returns an error code 500 in 10% of the requests.

JavaScript
const fault = {
  averageDelay: '50ms',
  errorCde: 500,
  errorRate: 0.1,
};