Skip to content

Commit 3e5f770

Browse files
authored
docs: clarify definition of network health (#4729)
Update the documentation to describe network health with more nuance as well as context about related factors.
1 parent 2a66bb3 commit 3e5f770

File tree

1 file changed

+21
-5
lines changed

1 file changed

+21
-5
lines changed

src/ripple/app/misc/FeeEscalation.md

+21-5
Original file line numberDiff line numberDiff line change
@@ -190,11 +190,27 @@ lower) fee to get into the same position as a reference transaction.
190190

191191
### Consensus Health
192192

193-
For consensus to be considered healthy, the consensus process must take
194-
less than 5 seconds. This time limit was chosen based on observed past
195-
behavior of the network. Note that this is not necessarily the time between
196-
ledger closings, as consensus usually starts some amount of time after
197-
a ledger opens.
193+
For consensus to be considered healthy, the peers on the network
194+
should largely remain in sync with one another. It is particularly
195+
important for the validators to remain in sync, because that is required
196+
for participation in consensus. However, the network tolerates some
197+
validators being out of sync. Fundamentally, network health is a
198+
function of validators reaching consensus on sets of recently submitted
199+
transactions.
200+
201+
Another factor to consider is
202+
the duration of the consensus process itself. This generally takes
203+
under 5 seconds on the main network under low volume. This is based on
204+
historical observations. However factors such as transaction volume
205+
can increase consensus duration. This is because rippled performs
206+
more work as transaction volume increases. Under sufficient load this
207+
tends to increase consensus duration. It's possible that relatively high
208+
consensus duration indicates a problem, but it is not appropriate to
209+
conclude so without investigation. The upper limit for consensus
210+
duration should be roughly 20 seconds. That is far above the normal.
211+
If the network takes this long to close ledgers, then it is almost
212+
certain that there is a problem with the network. This circumstance
213+
often coincides with new ledgers with zero transactions.
198214

199215
### Other Constants
200216

0 commit comments

Comments
 (0)