Injecting faults with xk6-disruptor

xk6-disruptor is an extension that adds fault injection capabilities to k6. It implements the principles of the Chaos Engineering discipline to test the reliability of our applications under turbulent conditions such as delays and response errors.

Key features include:

Everything as code. Facilitate test reuse and collaboration between teams without learning a new DSL.
Fast to adopt with no day-two surprises. No need to deploy and maintain a fleet of agents or operators.
Easy to extend and integrate with other types of k6 tests. No need to try to glue multiple tools together to get the job done.

Capabilities

Currently, the disruptor is intended to test applications running in Kubernetes. Other platforms are not supported at this time.

It provides a Javascript API to inject different faults in HTTP and gRPC requests, such as errors and delays, into the selected Kubernetes Pods or Services.

Other types of faults and disruptors will be introduced in the future. The Roadmap presents the project’s goals for the coming months regarding new functionalities and enhancements.

Use cases

The disruptor lets you test the resiliency of distributed applications by introducing errors in the requests served by your services.

The disruptor does not try to reproduce root causes, such as failed application instances or degraded computing or network resources. It focuses on reproducing the side effects of such failures, so you can focus on understanding the propagation of errors between internal and public services and improving the error handling in your application.

This way, the disruptor makes reliability tests repeatable and predictable while limiting their blast radius. These are essentials to test applications deployed on shared infrastructures such as pre-production and testing environments.

Common use cases are: