aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/fail_fast.md
blob: 3ed4297194b408a5c4bb0b0a047105d767cf3d86 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
gRPC Fail Fast Semantics
========================

Fail fast requests allow terminating requests (with status UNAVAILABLE) prior
to the deadline of the request being met.

gRPC implementations of fail fast can terminate requests whenever a channel is
in the TRANSIENT_FAILURE or SHUTDOWN states. If the channel is in any other
state (CONNECTING, READY, or IDLE) the request should not be terminated.

Fail fast SHOULD be the default for gRPC implementations, with an option to
switch to non fail fast.

The opposite of fail fast is 'ignore connectivity'.