redis - sentinel配置项
简介
redis sentinel为redis server提供高可用性。sentinel哨兵模式已经被集成在redis2.4之后的版本中。
sentinel系统可以监视一个或者多个redis主节点服务,以及这些主节点服务的所有从服务;当某个master服务下线时,自动将该主节点下的某个从服务升级为主节点服务替代已下线的master服务继续处理请求。
sentinel 配置
sentinel监听端口,默认是26379,可以修改。
port 26379
sentinel monitor <master-name> <ip> <redis-port> <quorum>
告诉sentinel去监听地址为ip port的一个master,这里的master-name可以自定义,quorum是一个数字,指明当有多少个sentinel认为一个master失效时,master才算真正失效。
master-name只能包含英文字母,数字,和".-_"这三个字符需要注意的是master-ip 要写真实的ip地址而不要用回环地址(127.0.0.1)。
例如:
sentinel monitor myredis 192.168.10.100 6379 2
sentinel auth-pass <master-name> <password>
设置连接master和slave时的密码,注意的是sentinel不能分别为master和slave设置不同的密码,因此master和slave的密码应该设置相同。
例如:
sentinel auth-pass myredis myredispassword
sentinel down-after-milliseconds <master-name> <milliseconds>
这个配置项指定了需要多少失效时间,一个master才会被这个sentinel主观地认为是不可用的。 单位是毫秒,默认为30秒
例如:
sentinel down-after-milliseconds myredis 30000
sentinel parallel-syncs <master-name> <numslaves>
在发生failover主备切换时最多可以有多少个slave同时对新的master进行同步,这个数字越小,完成failover所需的时间就越长,但是如果这个数字越大,就意味着越多的slave因为replication而不可用。
可以通过将这个值设为 1 来保证每次只有一个slave 处于不能处理命令请求的状态。
例如:
sentinel parallel-syncs myredis 1
sentinel failover-timeout <master-name> <milliseconds>
failover-timeout 可以用在以下这些方面:
- 1. 同一个sentinel对同一个master两次failover之间的间隔时间。
- 2. 当一个slave从一个错误的master那里同步数据开始计算时间。直到slave被纠正为向正确的master那里同步数据时。
- 3.当想要取消一个正在进行的failover所需要的时间。
- 4.当进行failover时,配置所有slaves指向新的master所需的最大时间。不过,即使过了这个超时,slaves依然会被正确配置为指向master,但是就不按parallel-syncs所配置的规则来了。
例如:
sentinel failover-timeout myredis 20000
执行脚本
sentinel的notification-script和reconfig-script是用来配置当某一事件发生时所需要执行的脚本,可以通过脚本来通知管理员。
例如当系统运行不正常时发邮件通知相关人员。对于脚本的运行结果有以下规则:
- 若脚本执行后返回1,那么该脚本稍后将会被再次执行,重复次数目前默认为10
- 若脚本执行后返回2,或者比2更高的一个返回值,脚本将不会重复执行。
- 如果脚本在执行过程中由于收到系统中断信号被终止了,则同返回值为1时的行为相同。
- 一个脚本的最大执行时间为60s,如果超过这个时间,脚本将会被一个SIGKILL信号终止,之后重新执行。
sentinel notification-script <master-name> <script-path>
当sentinel有任何告警级别的时间发生时,将会去调用调用这个脚本。调用该脚本时,将传给脚本两个参数,一个是事件的类型,一个是事件的描述。
如果sentinel.conf配置文件中配置了这个脚本路径,那么必须保证这个脚本存在于这个路径,并且是可执行的,否则sentinel无法正常启动成功。
例如:
sentinel notification-script myredis /opt/redis/notify.sh
sentinel client-reconfig-script <master-name> <script-path>
当一个master由于failover而发生改变时,这个脚本将会被调用,通知相关的客户端关于master地址已经发生改变的信息。
以下参数将会在调用脚本时传给脚本:
<master-name> <role> <state> <from-ip> <from-port> <to-ip> <to-port>
目前<state>总是"failover", <role>是"leader"或者"observer"中的一个。 参数 from-ip, from-port, to-ip, to-port是用来和旧的master和新的master(即旧的slave)通信的。这个脚本应该是通用的,能被多次调用,不是针对性的。