3
3
Copyright (c) 2007-2016 Pivotal Software, Inc.
4
4
5
5
All rights reserved. This program and the accompanying materials
6
- are made available under the terms of the under the Apache License,
7
- Version 2.0 (the "License”); you may not use this file except in compliance
6
+ are made available under the terms of the under the Apache License,
7
+ Version 2.0 (the "License”); you may not use this file except in compliance
8
8
with the License. You may obtain a copy of the License at
9
9
10
10
http://www.apache.org/licenses/LICENSE-2.0
@@ -102,6 +102,26 @@ cf.RequestedHeartbeat = 60;
102
102
</pre >
103
103
</doc : section >
104
104
105
+ <doc : section name =" false-positives" >
106
+ <doc : heading >Low Timeout Values and False Positives</doc : heading >
107
+ <p >
108
+ Setting heartbeat timeout value too low can lead to false
109
+ positives (peer being considered unavailable while it really
110
+ isn't the case) due to transient network congestion,
111
+ short-lived server flow control, and so on.
112
+
113
+ This should be taken into consideration when picking a timeout
114
+ value.
115
+ </p >
116
+ <p >
117
+ Several years worth of feedback from the users and client
118
+ library maintainers suggest that values lower than 5 seconds
119
+ are fairly likely to cause false positives, and values of 1
120
+ second or lower are very likely to do so. Values within the 5
121
+ to 20 seconds range are optimal for most environments.
122
+ </p >
123
+ </doc : section >
124
+
105
125
<doc : section name =" stomp" >
106
126
<doc : heading >Heartbeats in STOMP</doc : heading >
107
127
<p >
@@ -114,5 +134,17 @@ cf.RequestedHeartbeat = 60;
114
134
</p >
115
135
</doc : section >
116
136
137
+ <doc : section name =" shovel-and-federation" >
138
+ <doc : heading >Heartbeats in Shovel and Federation Plugins</doc : heading >
139
+ <p >
140
+ <a href =" /shovel.html" >Shovel</a > and <a href =" /federation.html" >Federation</a > plugins open Erlang client
141
+ connections to RabbitMQ nodes under the hood. As such, they can be configured
142
+ to use a desired heartbeat value.
143
+ </p >
144
+ <p >
145
+ Please refer to the <a href =" /uri-query-parameters.html" >AMQP 0-9-1 URI query parameters reference</a >
146
+ for details.
147
+ </p >
148
+ </doc : section >
117
149
</body >
118
150
</html >
0 commit comments