Skip to content

Commit 3e71db6

Browse files
authored
Mention zero-window state in networking docs (elastic#124969)
Clarify that it is expected sometimes to see inter-node connections sending zero-window advertisements as part of the usual TCP backpressure mechanism. Backport of elastic#124967 to 8.x
1 parent c75e012 commit 3e71db6

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

docs/reference/modules/transport.asciidoc

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -195,6 +195,15 @@ setting `transport.ping_schedule` if keepalives cannot be configured. Devices
195195
which drop connections when they reach a certain age are a common source of
196196
problems to {es} clusters, and must not be used.
197197

198+
If an {es} node is temporarily unable to handle network traffic it may stop
199+
reading data from the network and advertise a zero-length TCP window to its
200+
peers so that they pause the transmission of data to the unavailable node. This
201+
is the standard backpressure mechanism built into TCP. When the node becomes
202+
available again, it will resume reading from the network. Configure your
203+
network to permit TCP connections to exist in this paused state without
204+
disruption. Do not impose any limit on the length of time that a connection may
205+
remain in this paused state.
206+
198207
For information about troubleshooting unexpected network disconnections, see
199208
<<troubleshooting-unstable-cluster-network>>.
200209

0 commit comments

Comments
 (0)