ServiceDisruptor on Grafana Labs

Constructor

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

Constructor

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

Parameter	Type	Description
service	string	name of the service
namespace	string	namespace on which the service is defined
options (optional)	object	options for controlling the behavior of the disruptor

Options

The following options control the creation and behavior of the ServiceDisruptor:

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

Example

const disruptor = new ServiceDisruptor('my-service', 'my-namespace');

injectGrpcFaults

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

injectGrpcFaults

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

Parameters	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 Service.

Parameters	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 due to 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 pods that belong to the service specified in the ServiceDisruptor.

Parameter	Type	Description
fault	object	description of the Pod Termination fault

Example

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