Skip to content

Commit bdb108d

Browse files
committed
Add mirroring_sync_batch_size to example config
1 parent 946ce16 commit bdb108d

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/rabbitmq.config.example

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -299,6 +299,24 @@
299299
%% See https://www.rabbitmq.com/ha.html#queue-master-location for further details
300300
%% {queue_master_locator, <<"client-local">>},
301301

302+
%% Since RabbitMQ 3.6.0, masters perform synchronisation in batches.
303+
%% Earlier versions will synchronise 1 message at a time by default.
304+
%% By synchronising messages in batches, the synchronisation process can be sped up considerably.
305+
%% To choose the right value, you need to consider:
306+
%% * average message size
307+
%% * network throughput between RabbitMQ nodes
308+
%% * net_ticktime value
309+
%%
310+
%% For example, if you set this value to 50000 (messages),
311+
%% and each message in the queue is 1KB,
312+
%% then each synchronisation message between nodes will be ~49MB.
313+
%%
314+
%% You need to make sure that your network between queue mirrors can accomodate this kind of traffic.
315+
%%
316+
%% If the network takes longer than net_ticktime to send one batch of messages,
317+
%% then nodes in the cluster could think they are in the presence of a network partition.
318+
%% {mirroring_sync_batch_size, 4096},
319+
302320
%% To announce custom properties to clients on connection:
303321
%%
304322
%% {server_properties, []},

0 commit comments

Comments
 (0)