Fault Injection

New to Kuma? You need this policy, check MeshFaultInjection instead.

Fault Injection is an inbound policy. Dataplanes whose configuration is modified are in the destinations matcher.

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

  1. apiVersion: kuma.io/v1alpha1
  2. kind: FaultInjection
  3. mesh: default
  4. metadata:
  5.   name: fi1
  6. spec:
  7.   sources:
  8.     - match:
  9.         kuma.io/service: frontend_default_svc_80
  10.         version: "0.1"
  11.         kuma.io/protocol: http
  12.   destinations:
  13.     - match:
  14.         kuma.io/service: backend_default_svc_80
  15.         kuma.io/protocol: http
  16.   conf:        
  17.     abort:
  18.       httpStatus: 500
  19.       percentage: 50
  20.     delay:
  21.       percentage: 50.5
  22.       value: 5s
  23.     responseBandwidth:
  24.       limit: 50 mbps
  25.       percentage: 50
  1. type: FaultInjection
  2. mesh: default
  3. name: fi1
  4. sources:
  5.   - match:
  6.       kuma.io/service: frontend
  7.       version: "0.1"
  8. destinations:
  9.   - match:
  10.       kuma.io/service: backend
  11.       kuma.io/protocol: http
  12. conf:        
  13.   abort:
  14.     httpStatus: 500
  15.     percentage: 50
  16.   delay:
  17.     percentage: 50.5
  18.     value: 5s
  19.   responseBandwidth:
  20.     limit: 50 mbps
  21.     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 side
  • percentage - 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 delayed
  • percentage - 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. 10kbps
  • percentage - 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.

All options