redis的repl-ping-slave-period和repl-ping-replica-period

清疚 2022-03-30 14:38 160阅读 0赞

网上很多Redis方面的文章，会涉及到**repl-ping-****slave****-period**和**repl-ping-****replica****-period**这两个重要参数，从一些中文解释来看，意思差不多，即：SLAVE周期性的ping MASTER间隔，可直接理解成**SLAVE**** **\-> MASTER间的心跳间隔（注意箭头方向）。

没有一篇文章同时提取这两者，总是分开出现在不同文章中。在官方的配置文件[redis.conf][]，5.0版本之前的均使用**repl-ping-****slave****-period**，而从5.0开始变成了**repl-ping-****replica****-period**，也就是说这两个其实是同一个东西。实际上因为一些非技术原因，很多软件将**slave**改成了**replica**，Redis也同样如此，所以**replica**和**slave**是**完全相同**的。

为了兼容，5.0同时支持两种用法（其它配置项也同样命运，如：slaveof改成了replicaof）：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} else if ((!strcasecmp(argv[0],"repl-ping-slave-period") || &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;!strcasecmp(argv[0],"repl-ping-replica-period")) &amp;&amp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;argc == 2) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;server.repl_ping_slave_period&nbsp;= atoi(argv[1]); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (server.repl_ping_slave_period &lt;= 0) { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;err = "repl-ping-replica-period must be 1 or greater"; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;goto loaderr; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} </td> 
 </tr> 
 </tbody> 
</table>

常用命令变化，但5.0仍然兼容的配置项（实际上所有的**slave**都改成了**replica**，包括一些官方网站的文档，不过代码中的变量名保持未变，仍就为**slave**）：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:213.05pt;"> &lt;5.0版本 </td> 
 <td style="vertical-align:top;width:213.05pt;"> &gt;=5.0版本 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:213.05pt;"> repl-ping-slave-period </td> 
 <td style="vertical-align:top;width:213.05pt;"> repl-ping-replica-period </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:213.05pt;"> slaveof </td> 
 <td style="vertical-align:top;width:213.05pt;"> replicaof </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:213.05pt;"> slave-priority </td> 
 <td style="vertical-align:top;width:213.05pt;"> replica-priority </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:213.05pt;"> slave-read-only </td> 
 <td style="vertical-align:top;width:213.05pt;"> replica-read-only </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:213.05pt;"> slave-serve-stale-data </td> 
 <td style="vertical-align:top;width:213.05pt;"> replica-serve-stale-data </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:213.05pt;"> cluster-slave-validity-factor </td> 
 <td style="vertical-align:top;width:213.05pt;"> cluster-replica-validity-factor </td> 
 </tr> 
 </tbody> 
</table>

配置项说明（注意命名包含cluster的为集群专有配置项）：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:147.35pt;"> &nbsp; </td> 
 <td style="vertical-align:top;width:40.2pt;"> 默认值 </td> 
 <td style="vertical-align:top;width:31.2pt;"> 单位 </td> 
 <td style="vertical-align:top;width:207.35pt;"> &nbsp; </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:147.35pt;"> repl-ping-replica-period </td> 
 <td style="vertical-align:top;width:40.2pt;"> 10 </td> 
 <td style="vertical-align:top;width:31.2pt;"> 秒 </td> 
 <td style="vertical-align:top;width:207.35pt;"> 定义心跳（PING）间隔。 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:147.35pt;"> repl-timeout </td> 
 <td style="vertical-align:top;width:40.2pt;"> 60 </td> 
 <td style="vertical-align:top;width:31.2pt;"> 秒 </td> 
 <td style="vertical-align:top;width:207.35pt;"> 这个参数一定不能小于repl-ping-replica-period，可以考虑为repl-ping-replica-period的3倍或更大。定义多长时间内均PING不通时，判定心跳超时。对于redis集群，达到这个值并不会发生主从切换,主从何时切换由参数cluster-node-timeout控制，只有master状态为fail后，它的slaves才能发起选举。 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:147.35pt;"> cluster-node-timeout </td> 
 <td style="vertical-align:top;width:40.2pt;"> 15000 </td> 
 <td style="vertical-align:top;width:31.2pt;"> 毫秒 </td> 
 <td style="vertical-align:top;width:207.35pt;"> 集群中的节点最大不可用时长，在这个时长内，不会被判定为fail。对于master节点，当不可用时长超过此值时，它slave在延迟至少0.5秒后会发起选举进行failover成为master。Redis集群的很多其它值与cluster-node-timeout有关。 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;width:147.35pt;"> cluster-slave-validity-factor </td> 
 <td style="vertical-align:top;width:40.2pt;"> 10 </td> 
 <td style="vertical-align:top;width:31.2pt;"> &nbsp; </td> 
 <td style="vertical-align:top;width:207.35pt;"> 如果设置为0，则slave总是尝试成为master，无论slave和master间的链接断开时间的长短。如果是一个大于0的值，则最大可断开时长为：(cluster-slave-validity-factor * cluster-node-timeout)。例如：当cluster-node-timeout值为5，cluster-slave-validity-factor值为10时，slave和master间的连接断开50秒内，slave不会尝试成为master。 </td> 
 </tr> 
 </tbody> 
</table>

repl-timeout和cluster-node-timeout的区别：

[redis.conf]: https://raw.githubusercontent.com/antirez/redis/5.0.3/redis.conf