Careful!
You are browsing documentation for a version of Kuma that is not the latest release.
Looking for even older versions? Learn more.
Fault Injection
FaultInjection
policy helps you to test your microservices against resiliency. Kuma provides 3 different types of failures that could be imitated in your environment.
These faults are Delay, Abort and ResponseBandwidth limit.
Usage
apiVersion: kuma.io/v1alpha1
kind: FaultInjection
mesh: default
metadata:
name: fi1
spec:
sources:
- match:
kuma.io/service: frontend
version: "0.1"
kuma.io/protocol: http
destinations:
- match:
kuma.io/service: backend
kuma.io/protocol: http
conf:
abort:
httpStatus: 500
percentage: 50
delay:
percentage: 50.5
value: 5s
responseBandwidth:
limit: 50 mbps
percentage: 50
Sources & Destinations
FaultInjection
is a policy, which is applied to the connection between dataplanes. As most of the policies, FaultInjection
supports the powerful mechanism of matching, which allows you to precisely match source and destination dataplanes.
FaultInjection
policy is available only for L7 HTTP traffic,
therefore kuma.io/protocol
is a mandatory tag for the destination selector
and must be of value http
, http2
or grpc
.
HTTP Faults
At least one of the following Faults should be specified.
Abort
Abort defines a configuration of not delivering requests to destination service and replacing the responses from destination dataplane by predefined status code.
httpStatus
- HTTP status code which will be returned to source sidepercentage
- percentage of requests on which abort will be injected, has to be in [0.0 - 100.0] range
Delay
Delay defines configuration of delaying a response from a destination.
value
- the duration during which the response will be delayedpercentage
- percentage of requests on which delay will be injected, has to be in [0.0 - 100.0] range
ResponseBandwidth limit
ResponseBandwidth defines a configuration to limit the speed of responding to the requests.
limit
- represented by value measure in gbps, mbps, kbps or bps, e.g. 10kbpspercentage
- percentage of requests on which response bandwidth limit will be injected, has to be in [0.0 - 100.0] range
Matching
FaultInjection
is an Inbound Connection Policy.
You can use all the tags in both sources
and destinations
sections.