Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/k6/next/testing-guides/injecting-faults-with-xk6-disruptor/first-steps.md, or by sending Accept: text/markdown to https://grafana.com/docs/k6/next/testing-guides/injecting-faults-with-xk6-disruptor/first-steps/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.
xk6-disruptor first steps
xk6-disruptor is an extension that adds fault injection capabilities to k6.
It provides a Javascript API to inject faults such as errors and delays into HTTP and gRPC requests served by selected Kubernetes Pods or Services.
import { ServiceDisruptor } from 'k6/x/disruptor';
export default function () {
// Create a new disruptor that targets a service
const disruptor = new ServiceDisruptor('app-service', 'app-namespace');
// Disrupt the targets by injecting delays and faults into HTTP request for 30 seconds
const fault = {
averageDelay: '500ms',
errorRate: 0.1,
errorCode: 500,
};
disruptor.injectHTTPFaults(fault, '30s');
}Next steps
Explore the fault injection API
Visit the interactive demo environment.
Learn the basics of using the disruptor in your test project:
Was this page helpful?
Related resources from Grafana Labs

