Redis.conf及其Sentinel.conf配置项详细说明

Posted 2020-09-27 法号阿兴

一、redis.conf 配置项说明如下：

1. daemonize no

Redis默认不是以守护进程的方式运行，可以通过该配置项修改，使用yes启用守护进程

 

2. pidfile /var/run/redis_6379.pid

当Redis以守护进程方式运行时，即使该项没有配置，Redis也会默认把pid写入/var/run/redis.pid文件；而当Redis不是以守护进程凡是运行时，若该项没有配置，则redis不会创建pid文件。创建pid文件是尝试性的动作，即使创建写入失败，redis依然可以启动运行

 

3.port 6379

指定Redis监听端口，默认端口为6379，作者在自己的一篇博文中解释了为什么选用6379作为默认端口，因为6379在手机按键上MERZ对应的号码，而MERZ取自意大利歌女Alessia Merz的名字

 

4.bind 127.0.0.1

绑定的主机地址，如果想全部访问不做限制的话，全为0.0.0.0,

 

5.timeout 300

当 客户端闲置多长时间后关闭连接，如果指定为0，表示关闭该功能

 

6.loglevel verbose

 指定日志记录级别，Redis总共支持四个级别：debug、verbose、notice、warning，默认为verbose

 

7.logfile ""

日志记录方式，配置空字符串强制让日志打到标准输出，如果配置Redis为守护进程方式运行，而这里又配置为日志记录方式为标准输出，则日志将会发送给/dev/null

 

8.databases 16

 设置数据库的数量，默认数据库为0，可以使用SELECT <dbid>命令在连接上指定数据库id

 

9  save <seconds> <changes>

指定在多长时间内，有多少次更新操作，就将数据同步到数据文件，可以多个条件配合

    Redis默认配置文件中提供了三个条件：

    save 900 1

    save 300 10

    save 60 10000

    分别表示900秒（15分钟）内有1个更改，300秒（5分钟）内有10个更改以及60秒内有10000个更改。

 

10. stop-writes-on-bgsave-error yes 

如果以RDB的方式持久化数据时出错了，redis默认将不接收写入操作，以便让应用层感知出现问题了，配置为no禁用；

 

11.rdbcompression yes

指定存储至本地数据库时是否压缩数据，默认为yes，Redis采用LZF压缩，如果为了节省CPU时间，可以关闭该选项，但会导致数据库文件变的巨大

 

 

12.dbfilename dump.rdb

 指定本地数据库文件名，默认值为dump.rdb

 

13.dir ./

指定本地数据库存放目录

 

14. slaveof <masterip> <masterport>

设置当本机为slave服务时，设置master服务的IP地址及端口，在Redis启动时，它会自动从master进行数据同步

 

15.slave-serve-stable-data yes

 当一个slave失去与其master的连接时，该配置用来指定slave是否继续接收client的请求，指定为yes则继续接收，指定为no，则slave会回复"SYNC with master in progress"错误给client的所有请求（除了info和slaveof命令外）

 

16.slave-read-only yes

slave是否是只读的，默认为yes

 

17 repl-diskless-sync no

master与slave同步策略：disk or socket

slave与master同步时，master会生成rdb file并传输给该slave，这个传输过程有两种形式：

1.Disk-backed：master fork出一个子进程来把rdb file先写入disk，然后再由主进程将该rdb发给slaves

2.Diskless：master fork出一个子进程来直接把rdb file发送给slaves，在这个过程中，master就无法给其它slave提供同步，后面的slave的同步都得入队列。但是可以指定master 再fork之前等待多久，以尽可能地同时将rdb file发给多个slave

 

18.repl-diskless-sync-delay 5

指定的delay，单位second

 

 19. repl-ping-slave-period 10

slave发送心跳间隔，单位second

   

 20.repl-timeout 60

该配置指定了：

1.同步时slave端的IO超时

2.master超时（从slave的角度，data，ping）

3.slave超时（从master的角度）

单位second

比如 repl-ping-slave-period配置为10而该项配60，则如果slave连续发了6次ping，都没有收到来自master的pong，则slave会主观地认为该master已死

    

21.repl-disable-tcp-nodelay no

 

22.repl-backlog-size 1mb

slave同步缓冲区大小

 

23.repl-backlog-ttl 3600

slave同步缓冲区存活时间（当master与对应的slave断开连接后）

 

24.slave-priority 100

slave的被选举优先级，越小越优先，但设为0则没有被选举权，默认为100

 

25. masterauth <master-password>

 当master设置了密码保护时，slave连接master的密码

 

26 requirepass foobared

 设置Redis连接密码，如果配置了连接密码，客户端在连接Redis时需要通过masterauth提供密码，默认关闭

 

27 maxclients 128

设置同一时间最大客户端连接数，默认无限制，Redis可以同时打开的客户端连接数为Redis进程可以打开的最大文件描述符数，如果设置 maxclients 0，表示不作限制。当客户端连接数到达限制时，Redis会关闭新的连接并向客户端返回max number of clients reached错误信息

 

28 maxmemory <bytes>

指定Redis最大内存限制，Redis在启动时会把数据加载到内存中，达到最大内存后，Redis会先尝试清除已到期或即将到期的Key，当此方法处理 后，仍然到达最大内存设置，将无法再进行写入操作，但仍然可以进行读取操作。Redis新的vm机制，会把Key存放内存，Value会存放在swap区，若设为0，则不限制内存，64位系统默认不限制内存，而32位系统默认最大为3GB

 

maxmemory-policy (noeviction | allkeys-lru | volatile-lru | allkeys-random | volatile-random | volatile-ttl)

当内存到达阀值时redis对于会增加内存的命令的处理策略：

noeviction：返回错误

allkeys-lru：对于所有的key采用lru算法删掉一些key

volatile-lru：对于所有有超时的key采用lru算法删掉一些key

allkeys-random：对于所有的key采用随机算法删掉一些key

volatile-random：对于所有有超时的key采用随机算法删掉一些key

volatile-ttl：对于所有有超时的key采用随机算法删掉一些key，优先删除存活时间短的那些

 

29.appendonly no

指定是否在每次更新操作后进行日志记录，Redis在默认情况下是异步的把数据写入磁盘，如果不开启，可能会在断电时导致一段时间内的数据丢失。因为 redis本身同步数据文件是按上面save条件来同步的，所以有的数据会在一段时间内只存在于内存中。默认为no

 

30.appendfilename appendonly.aof

指定更新日志文件名，默认为appendonly.aof

 

31.appendfsync everysec

指定更新日志条件，共有3个可选值： 
    no：表示等操作系统进行数据缓存同步到磁盘（快） 
    always：表示每次更新操作后手动调用fsync()将数据写到磁盘（慢，安全） 
    everysec：表示每秒同步一次（折衷，默认值）

 

32.vm-enabled no

 指定是否启用虚拟内存机制，默认值为no，简单的介绍一下，VM机制将数据分页存放，由Redis将访问量较少的页即冷数据swap到磁盘上，访问多的页面由磁盘自动换出到内存中（在后面的文章我会仔细分析Redis的VM机制）

 

33 vm-swap-file /tmp/redis.swap

虚拟内存文件路径，默认值为/tmp/redis.swap，不可多个Redis实例共享

 

34 vm-max-memory 0

将所有大于vm-max-memory的数据存入虚拟内存,无论vm-max-memory设置多小,所有索引数据都是内存存储的(Redis的索引数据 就是keys),也就是说,当vm-max-memory设置为0的时候,其实是所有value都存在于磁盘。默认值为0

 

35.vm-page-size 32

Redis swap文件分成了很多的page，一个对象可以保存在多个page上面，但一个page上不能被多个对象共享，vm-page-size是要根据存储的 数据大小来设定的，作者建议如果存储很多小对象，page大小最好设置为32或者64bytes；如果存储很大大对象，则可以使用更大的page，如果不 确定，就使用默认值

 

36. vm-pages 134217728

设置swap文件中的page数量，由于页表（一种表示页面空闲或使用的bitmap）是在放在内存中的，，在磁盘上每8个pages将消耗1byte的内存。

 

37 vm-max-threads 4

设置访问swap文件的线程数,最好不要超过机器的核数,如果设置为0,那么所有对swap文件的操作都是串行的，可能会造成比较长时间的延迟。默认值为4

 

38 glueoutputbuf yes

设置在向客户端应答时，是否把较小的包合并为一个包发送，默认为开启

 

39 

    hash-max-zipmap-entries 64

    hash-max-zipmap-value 512

指定在超过一定的数量或者最大的元素超过某一临界值时，采用一种特殊的哈希算法

 

40. activerehashing yes

指定是否激活重置哈希，默认为开启

 

41 include /path/to/local.conf

指定包含其它的配置文件，可以在同一主机上多个Redis实例之间使用同一份配置文件，而同时各个实例又拥有自己的特定配置文件

 

42 slowlog-log-slower-than 10000

单位microsecond，指定多慢的命令才会被记录到慢日志中，这个时间是命令的纯执行时间，即不包括IO等的时间，若 < 0则不记录慢日志，若为0则记录每一条命令

 

42 slowlog-max-len 1024

 最大慢日志记录条数

 

 

二、redis-sentinel.conf配置项说明如下：

 

1.port 26379

sentinel监听端口，默认是26379，可以修改。

 

2.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 mymaster 192.168.0.5 6379 2

 

3.sentinel auth-pass <master-name> <password>

设置连接master和slave时的密码，注意的是sentinel不能分别为master和slave设置不同的密码，因此master和slave的密码应该设置相同。

配置示例：

sentinel auth-pass mymaster 0123passw0rd

 

4.sentinel down-after-milliseconds <master-name> <milliseconds> 

这个配置项指定了需要多少失效时间，一个master才会被这个sentinel主观地认为是不可用的。 单位是毫秒，默认为30秒

配置示例：

sentinel down-after-milliseconds mymaster 30000

 

5.sentinel parallel-syncs <master-name> <numslaves> 

这个配置项指定了在发生failover主备切换时最多可以有多少个slave同时对新的master进行 同步，这个数字越小，完成failover所需的时间就越长，但是如果这个数字越大，就意味着越 多的slave因为replication而不可用。可以通过将这个值设为 1 来保证每次只有一个slave 处于不能处理命令请求的状态。

配置示例：

sentinel parallel-syncs mymaster 1

 

6. 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 mymaster1 20000

 

7.sentinel的notification-script和reconfig-script是用来配置当某一事件发生时所需要执行的脚本，可以通过脚本来通知管理员，例如当系统运行不正常时发邮件通知相关人员。对于脚本的运行结果有以下规则：

        若脚本执行后返回1，那么该脚本稍后将会被再次执行，重复次数目前默认为10

        若脚本执行后返回2，或者比2更高的一个返回值，脚本将不会重复执行。

        如果脚本在执行过程中由于收到系统中断信号被终止了，则同返回值为1时的行为相同。

        一个脚本的最大执行时间为60s，如果超过这个时间，脚本将会被一个SIGKILL信号终止，之后重新执行。

1).sentinel notification-script <master-name> <script-path> 

通知型脚本:当sentinel有任何警告级别的事件发生时（比如说redis实例的主观失效和客观失效等等），将会去调用这个脚本，这时这个脚本应该通过邮件，SMS等方式去通知系统管理员关于系统不正常运行的信息。调用该脚本时，将传给脚本两个参数，一个是事件的类型，一个是事件的描述。如果sentinel.conf配置文件中配置了这个脚本路径，那么必须保证这个脚本存在于这个路径，并且是可执行的，否则sentinel无法正常启动成功。

  配置示例：

 sentinel notification-script mymaster /var/redis/notify.sh

 

2).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)通信的。这个脚本应该是通用的，能被多次调用，不是针对性的。

   配置示例：

   sentinel client-reconfig-script mymaster /var/redis/reconfig.sh