首页 > 代码库 > Redis.conf及其Sentinel.conf配置项详细说明

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

一、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

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