PodDisruptor on Grafana Labs

Constructor

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

Constructor

The PodDisruptor() constructor creates a new instance of a PodDisruptor class.

Parameter	Type	Description
selector	object	criteria for selecting the target pods
options (optional)	object	options for controlling the behavior of the disruptor

Selector

The selector defines the criteria a pod must satisfy to be a valid target:

Attribute	Type	Description
namespace	string	namespace the selector will look for pods
select	object	attributes that a pod must match to be selected
exclude	object	attributes that exclude a pod (even if it matches the select attributes)

You can use the following attributes to select or exclude pods:

Pod attributes

Attribute	Type	Description
labels	object	map with the labels to be matched for selection or exclusion

Options

The options control the creation and behavior of the PodDisruptor:

Attribute	Type	Description
injectTimeout	string	maximum time to wait for the disruptor to be ready in the target pods (default 30s)

Example

const selector = {
  namespace: 'my-namespace',
  select: {
    labels: {
      app: 'my-app',
    },
  },
};
const podDisruptor = new PodDisruptor(selector);

injectGrpcFaults()

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

injectGrpcFaults()

injectGrpcFaults injects gRPC faults in the requests served by a target Pod.

Parameter	Type	Description
fault	object	description of the gRPC faults to be injected
duration	string	duration of the disruption
options (optional)	object	options that control the injection of the fault

options

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

Option	Type	Description
proxyPort	number	port the agent will use to listen for requests in the target pods ( default `8000`)

Example

const fault = {
  averageDelay: '50ms',
  statusCode: 13,
  errorRate: 0.1,
};
disruptor.injectGrpcFaults(fault, '30s');

injectHTTPFaults()

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

injectHTTPFaults()

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

Parameter	Type	Description
fault	object	description of the http faults to be injected
duration	string	duration of the disruption
options (optional)	object	options that control the injection of the fault

options

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

Option	Type	Description
proxyPort	number	port 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 from a network connection reset.

Example

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

terminatePods()

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

terminatePods()

terminatePods terminates a number of the pods matching the selector configured in the PodDisruptor.

Parameter	Type	Description
fault	object	description of the Pod Termination fault

Example

const fault = {
  count: 2,
};
disruptor.terminatePods(fault);