From cf28da8420b007d836b0db9d865d74fee89cdbcd Mon Sep 17 00:00:00 2001 From: Dana Powers Date: Sat, 28 Dec 2019 21:53:24 -0800 Subject: Improve docs for reconnect_backoff_max_ms (#1976) --- kafka/admin/client.py | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) (limited to 'kafka/admin/client.py') diff --git a/kafka/admin/client.py b/kafka/admin/client.py index cc126c6..4e4e842 100644 --- a/kafka/admin/client.py +++ b/kafka/admin/client.py @@ -61,13 +61,14 @@ class KafkaAdminClient(object): wait before attempting to reconnect to a given host. Default: 50. reconnect_backoff_max_ms (int): The maximum amount of time in - milliseconds to wait when reconnecting to a broker that has + milliseconds to backoff/wait when reconnecting to a broker that has repeatedly failed to connect. If provided, the backoff per host will increase exponentially for each consecutive connection - failure, up to this maximum. To avoid connection storms, a - randomization factor of 0.2 will be applied to the backoff - resulting in a random range between 20% below and 20% above - the computed value. Default: 1000. + failure, up to this maximum. Once the maximum is reached, + reconnection attempts will continue periodically with this fixed + rate. To avoid connection storms, a randomization factor of 0.2 + will be applied to the backoff resulting in a random range between + 20% below and 20% above the computed value. Default: 1000. request_timeout_ms (int): Client request timeout in milliseconds. Default: 30000. connections_max_idle_ms: Close idle connections after the number of -- cgit v1.2.1