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

Documentationbreadcrumb arrow Grafana k6breadcrumb arrow Testing guidesbreadcrumb arrow Injecting faults with xk6-disruptorbreadcrumb arrow xk6-disruptor APIbreadcrumb arrow ServiceDisruptorbreadcrumb arrow injectHTTPFaults
Open source

injectHTTPFaults

injectHTTPFaults injects HTTP faults in the requests served by a target Service.

ParametersTypeDescription
faultobjectdescription of the http faults to be injected
durationstringduration of the disruption
options (optional)objectoptions that control the injection of the fault

Options

The injection of the fault is controlled by the following options:

OptionTypeDescription
proxyPortnumberport the agent will use to listen for requests in the target pods ( default 8000)

Note

When injecting faults you may find the following error message during the test execution:

WARN[0035] Request Failed error=“read tcp 172.18.0.1:43564->172.18.255.200:80: read: connection reset by peer”.

This is normal and means that one request was “in transit” at the time the faults were injected causing the request to fail due to a network connection reset.

Example

JavaScript 
const fault = {
  averageDelay: '50ms',
  errorCode: 500,
  errorRate: 0.1,
};
disruptor.injectHTTPFaults(fault, '30s');