xk6-disruptor API on Grafana Labs

Faults

Mon, 21 Sep 2026 15:16:28 +0000

Faults

A fault is as an abnormal condition that affects a system component and which may lead to a failure.

Fault type	Description
gRPC Fault	Fault affecting gRPC requests from a target
HTTP Fault	Fault affecting HTTP requests from a target
Pod Termination Fault	Fault terminating a number of target Pods

PodDisruptor

Mon, 21 Sep 2026 15:16:28 +0000

PodDisruptor

The PodDisruptor class can inject different types of faults into the pods that match a selection criteria.

To construct a PodDisruptor, use the PodDisruptor() constructor.

Methods

Method	Description
PodDisruptor.injectGrpcFaults()	Inject gRPC faults in the target Pods
PodDisruptor.injectHTTPFaults()	Inject HTTP faults in the target Pods
PodDisruptor.targets()	Returns the list of target Pods of the PodDisruptor
PodDisruptor.terminatePods()	executes a Pod Termination fault in the target Pods

Example

This example:

Creates a selector that matches all pods in the default namespace with the run=nginx label
Injects a delay of 100ms and makes 10 percent of requests return an http response code 500.

import { PodDisruptor } from 'k6/x/disruptor';

const selector = {
  namespace: 'default',
  select: {
    labels: {
      run: 'nginx',
    },
  },
};

const fault = {
  averageDelay: '100ms',
  errorRate: 0.1,
  errorCode: 500,
};

export default function () {
  const disruptor = new PodDisruptor(selector);
  disruptor.injectHTTPFaults(fault, '30s');
}

Note
You can test this script by first creating a pod running nginx with the command below, assuming you have kubectl installed in your environment:
Bash
kubectl run nginx --image=nginx
You can also use the xk6-kubernetes extension for creating these resources from your test script.

ServiceDisruptor

Mon, 21 Sep 2026 15:16:28 +0000

ServiceDisruptor

The ServiceDisruptor class can inject different types of faults into the pods that back a Kubernetes service.

To construct a ServiceDisruptor, use the ServiceDisruptor() constructor.

Methods

Method	Description
ServiceDisruptor.injectGrpcFaults()	Inject gRPC faults in the target Pods
ServiceDisruptor.injectHTTPFaults()	Inject HTTP faults in the target Pods
ServiceDisruptor.targets()	Returns the list of target Pods of the ServiceDisruptor
ServiceDisruptor.terminatePods()	executes a Pod Termination fault in the target Pods

Example

The following example:

Creates a disruptor for the nginx service
Injects a delay of 100ms and a 10 percent of requests that return an http response code 500.

import { ServiceDisruptor } from 'k6/x/disruptor';

const fault = {
  averageDelay: '100ms',
  errorRate: 0.1,
  errorCode: 500,
};

export default function () {
  const disruptor = new ServiceDisruptor('nginx', 'default');
  disruptor.injectHTTPFaults(fault, '30s');
}

Note
You can test this script by creating first a pod running nginx and exposing it as a service with the commands below, assuming you have kubectl installed in your environment:
Bash
> kubectl run nginx --image=nginx
> kubectl expose pod nginx --port 80
You can also use the xk6-kubernetes extension for creating these resources from your test script.