istio.io/_docs/reference/api/fault-injection.md

title	overview	order	layout	type
Fault Injection	Generated documentation for the Istio's Configuration Schemas	1010	docs	markdown

Index

• HTTPFaultInjection (message)
• HTTPFaultInjection.Abort (message)
• HTTPFaultInjection.Delay (message)

HTTPFaultInjection

HTTPFaultInjection can be used to specify one or more faults to inject while forwarding http requests to the destination specified in the route rule. Fault specification is part of a route rule. Faults include aborting the Http request from downstream service, and/or delaying proxying of requests. A fault rule MUST HAVE delay or abort or both.

Note: Delay and abort faults are independent of one another, even if both are specified simultaneously.

Field	Type	Description
delay	Delay	Delay requests before forwarding, emulating various failures such as network issues, overloaded upstream service, etc.
abort	Abort	Abort Http request attempts and return error codes back to downstream service, giving the impression that the upstream service is faulty.

Abort

Abort specification is used to prematurely abort a request with a pre-specified error code. The following example will return an HTTP 400 error code for 10% of the requests to the "ratings" service "v1".

destination: ratings.default.svc.cluster.local
route:
- tags:
    version: v1
httpFault:
  abort:
    percent: 10
    httpStatus: 400

The HttpStatus_ field is used to indicate the HTTP status code to return to the caller. The optional Percent_ field, a value between 0 and 100, is used to only abort a certain percentage of requests. If not specified, all requests are aborted.

Field	Type	Description
percent	float	percentage of requests to be aborted with the error code provided (0-100).
httpStatus	int32	REQUIRED. HTTP status code to use to abort the Http request.

Delay

Delay specification is used to inject latency into the request forwarding path. The following example will introduce a 5 second delay in 10% of the requests to the "v1" version of the "reviews" service.

destination: reviews.default.svc.cluster.local
route:
- tags:
    version: v1
httpFault:
  delay:
    percent: 10
    fixedDelay: 5s

The FixedDelay_ field is used to indicate the amount of delay in seconds. An optional Percent_ field, a value between 0 and 100, can be used to only delay a certain percentage of requests. If left unspecified, all request will be delayed.

Field	Type	Description
percent	float	percentage of requests on which the delay will be injected (0-100)
fixedDelay	Duration	REQUIRED. Add a fixed delay before forwarding the request. Format: 1h/1m/1s/1ms. MUST be >=1ms.