Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentation Grafana k6 Testing guides Injecting faults with xk6-disruptor Requirements

Requirements

The xk6-disruptor is a k6 extension. To use it in a k6 test script, you need to bundle a k6 extension that includes the disruptor. Refer to the Installation section for instructions on how to get this custom build.

xk6-disruptor needs to interact with the Kubernetes cluster on which the application under test is running. To do so, you must have the credentials to access the cluster in a kubeconfig file. Ensure that this file is pointed to by the KUBECONFIG environment variable or that it is located at the default location, $HOME/.kube/config.

xk6-disruptor requires the grafana/xk6-disruptor-agent image for injecting the disruptor agent into the disruption targets. Kubernetes clusters can be configured to restrict the download of images from public repositories. You need to ensure this image is available in the cluster where the application under test is running. Additionally, the xk6-disruptor-agent must run with network access privileges. Kubernetes clusters can be configured to restrict the privileges of containers. If you find an error similar to the following when using the xk6-disruptor, contact your cluster administrator and request the necessary privileges.

ERROR[0000] error creating PodDisruptor: pods “nginx” is forbidden: violates PodSecurity “baseline:latest”: non-default capabilities (container “xk6-agent” must not include “NET_ADMIN”, “NET_RAW” in securityContext.capabilities.add)

You also need to ensure your test application is accessible from the machine where the tests run. Refer to Expose your application section for instructions on how to make your application available from outside the Kubernetes cluster..