Skip to content

Commit c717d57

Browse files
authored
Use repl_timeout instead of default value in heartbeat description (#3014)
* Format by style guide * Remove default value from description Resolves #1693
1 parent 2968009 commit c717d57

File tree

2 files changed

+33
-31
lines changed

2 files changed

+33
-31
lines changed

doc/book/replication/repl_monitoring.rst

Lines changed: 22 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
11
.. _replication-monitoring:
22

3-
================================================================================
43
Monitoring a replica set
5-
================================================================================
4+
========================
65

76
To learn what instances belong in the replica set, and obtain statistics for all
87
these instances, issue a :doc:`/reference/reference_lua/box_info/replication` request:
98

10-
.. code-block:: tarantoolsession
9+
.. code-block:: tarantoolsession
1110
1211
tarantool> box.info.replication
1312
---
@@ -43,36 +42,36 @@ these instances, issue a :doc:`/reference/reference_lua/box_info/replication` re
4342
This report is for a master-master replica set of three instances, each having
4443
its own instance id, UUID and log sequence number.
4544

46-
.. image:: mm-3m-mesh.svg
45+
.. image:: mm-3m-mesh.svg
4746
:align: center
4847

4948
The request was issued at master #1, and the reply includes statistics for the
5049
other two masters, given in regard to master #1.
5150

5251
The primary indicators of replication health are:
5352

54-
.. _heartbeat:
53+
.. _heartbeat:
5554

56-
* :ref:`idle <box_info_replication_upstream_idle>`, the time (in seconds) since
57-
the instance received the last event from a master.
55+
* :ref:`idle <box_info_replication_upstream_idle>`, the time (in seconds) since
56+
the instance received the last event from a master.
5857

59-
A master sends heartbeat messages to a replica every second, and the master
60-
is programmed to disconnect if it does not see acknowledgments of the heartbeat messages
61-
within :ref:`replication_timeout <cfg_replication-replication_timeout>` * 4
62-
seconds.
58+
If the master has no updates to send to the replicas, it sends heartbeat messages
59+
every :ref:`replication_timeout <cfg_replication-replication_timeout>` seconds. The master
60+
is programmed to disconnect if it does not see acknowledgments of the heartbeat messages
61+
within ``replication_timeout`` * 4 seconds.
6362

64-
Therefore, in a healthy replication setup, ``idle`` should never exceed
65-
``replication_timeout``: if it does, either the replication is lagging
66-
seriously behind, because the master is running ahead of the replica, or the
67-
network link between the instances is down.
63+
Therefore, in a healthy replication setup, ``idle`` should never exceed
64+
``replication_timeout``: if it does, either the replication is lagging
65+
seriously behind, because the master is running ahead of the replica, or the
66+
network link between the instances is down.
6867

69-
* :ref:`lag <box_info_replication_upstream_lag>`, the time difference between
70-
the local time at the instance, recorded when the event was received, and the
71-
local time at another master recorded when the event was written to the
72-
:ref:`write ahead log <internals-wal>` on that master.
68+
* :ref:`lag <box_info_replication_upstream_lag>`, the time difference between
69+
the local time at the instance, recorded when the event was received, and the
70+
local time at another master recorded when the event was written to the
71+
:ref:`write ahead log <internals-wal>` on that master.
7372

74-
Since the ``lag`` calculation uses the operating system clocks from two different
75-
machines, do not be surprised if it’s negative: a time drift may lead to the
76-
remote master clock being consistently behind the local instance's clock.
73+
Since the ``lag`` calculation uses the operating system clocks from two different
74+
machines, do not be surprised if it’s negative: a time drift may lead to the
75+
remote master clock being consistently behind the local instance's clock.
7776

78-
For multi-master configurations, ``lag`` is the maximal lag.
77+
For multi-master configurations, ``lag`` is the maximal lag.

locale/ru/LC_MESSAGES/book/replication/repl_monitoring.po

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -99,16 +99,19 @@ msgstr ""
9999
":ref:`бездействие <box_info_replication_upstream_idle>`, время (в секундах) "
100100
"с момента получения последнего события от мастера."
101101

102+
#, fuzzy
102103
msgid ""
103-
"A master sends heartbeat messages to a replica every second, and the master "
104-
"is programmed to disconnect if it does not see acknowledgments of the "
105-
"heartbeat messages within :ref:`replication_timeout <cfg_replication-"
106-
"replication_timeout>` * 4 seconds."
104+
"If the master has no updates to send to the replicas, it sends heartbeat "
105+
"messages every :ref:`replication_timeout <cfg_replication-"
106+
"replication_timeout>` seconds. The master is programmed to disconnect if it "
107+
"does not see acknowledgments of the heartbeat messages within "
108+
"``replication_timeout`` * 4 seconds."
107109
msgstr ""
108-
"Мастер отправляет сообщения контрольного сигнала на реплику каждую секунду, "
109-
"и мастер запрограммирован на отключение, если он не получает сообщения "
110-
"контрольного сигнала дольше :ref:`replication_timeout <cfg_replication-"
111-
"replication_timeout>` * 4 секунд."
110+
"Если на мастере нет новых данных, требующих репликации, он отправляет на "
111+
"реплики сообщения контрольного сигнала каждые :ref:`replication_timeout "
112+
"<cfg_replication-replication_timeout>` секунд. Мастер запрограммирован на "
113+
"отключение, если он не получает сообщения контрольного сигнала дольше "
114+
"``replication_timeout`` * 4 секунд."
112115

113116
msgid ""
114117
"Therefore, in a healthy replication setup, ``idle`` should never exceed "

0 commit comments

Comments
 (0)