Redis及其Sentinel配置項詳細說明

一、redis.conf 配置項說明如下：

1. Redis預設不是以守護程序的方式運作，可以通過該配置項修改，使用yes啟用守護程序

    daemonize no

2. 當Redis以守護程序方式運作時，Redis預設會把pid寫入/var/run/redis.pid檔案，可以通過pidfile指定

    pidfile /var/run/redis.pid

3. 指定Redis監聽端口，預設端口為6379，作者在自己的一篇博文中解釋了為什麼選用6379作為預設端口，因為6379在手機按鍵上MERZ對應的号碼，而MERZ取自意大利歌女Alessia Merz的名字

    port 6379

4. 綁定的主機位址

    bind 127.0.0.1

5.當 用戶端閑置多長時間後關閉連接配接，如果指定為0，表示關閉該功能

    timeout 300

6. 指定日志記錄級别，Redis總共支援四個級别：debug、verbose、notice、warning，預設為verbose

    loglevel verbose

7. 日志記錄方式，預設為标準輸出，如果配置Redis為守護程序方式運作，而這裡又配置為日志記錄方式為标準輸出，則日志将會發送給/dev/null

    logfile stdout

8. 設定資料庫的數量，預設資料庫為0，可以使用SELECT <dbid>指令在連接配接上指定資料庫id

    databases 16

9. 指定在多長時間内，有多少次更新操作，就将資料同步到資料檔案，可以多個條件配合

    save <seconds> <changes>

    Redis預設配置檔案中提供了三個條件：

    save 900 1

    save 300 10

    save 60 10000

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

10. 指定存儲至本地資料庫時是否壓縮資料，預設為yes，Redis采用LZF壓縮，如果為了節省CPU時間，可以關閉該選項，但會導緻資料庫檔案變的巨大

    rdbcompression yes

11. 指定本地資料庫檔案名，預設值為dump.rdb

    dbfilename dump.rdb

12. 指定本地資料庫存放目錄

    dir ./

13. 設定當本機為slav服務時，設定master服務的IP位址及端口，在Redis啟動時，它會自動從master進行資料同步

    slaveof <masterip> <masterport>

14. 當master服務設定了密碼保護時，slav服務連接配接master的密碼

    masterauth <master-password>

15. 設定Redis連接配接密碼，如果配置了連接配接密碼，用戶端在連接配接Redis時需要通過AUTH <password>指令提供密碼，預設關閉

    requirepass foobared

16. 設定同一時間最大用戶端連接配接數，預設無限制，Redis可以同時打開的用戶端連接配接數為Redis程序可以打開的最大檔案描述符數，如果設定 maxclients 0，表示不作限制。當用戶端連接配接數到達限制時，Redis會關閉新的連接配接并向用戶端傳回max number of clients reached錯誤資訊

    maxclients 128

17. 指定Redis最大記憶體限制，Redis在啟動時會把資料加載到記憶體中，達到最大記憶體後，Redis會先嘗試清除已到期或即将到期的Key，當此方法處理 後，仍然到達最大記憶體設定，将無法再進行寫入操作，但仍然可以進行讀取操作。Redis新的vm機制，會把Key存放記憶體，Value會存放在swap區

    maxmemory <bytes>

18. 指定是否在每次更新操作後進行日志記錄，Redis在預設情況下是異步的把資料寫入磁盤，如果不開啟，可能會在斷電時導緻一段時間内的資料丢失。因為 redis本身同步資料檔案是按上面save條件來同步的，是以有的資料會在一段時間内隻存在于記憶體中。預設為no

    appendonly no

19. 指定更新日志檔案名，預設為appendonly.aof

     appendfilename appendonly.aof

20. 指定更新日志條件，共有3個可選值： 

    no：表示等作業系統進行資料緩存同步到磁盤（快） 

    always：表示每次更新操作後手動調用fsync()将資料寫到磁盤（慢，安全） 

    everysec：表示每秒同步一次（折衷，預設值）

    appendfsync everysec

21. 指定是否啟用虛拟記憶體機制，預設值為no，簡單的介紹一下，VM機制将資料分頁存放，由Redis将通路量較少的頁即冷資料swap到磁盤上，通路多的頁面由磁盤自動換出到記憶體中（在後面的文章我會仔細分析Redis的VM機制）

     vm-enabled no

22. 虛拟記憶體檔案路徑，預設值為/tmp/redis.swap，不可多個Redis執行個體共享

     vm-swap-file /tmp/redis.swap

23. 将所有大于vm-max-memory的資料存入虛拟記憶體,無論vm-max-memory設定多小,所有索引資料都是記憶體存儲的(Redis的索引資料 就是keys),也就是說,當vm-max-memory設定為0的時候,其實是所有value都存在于磁盤。預設值為0

     vm-max-memory 0

24. Redis swap檔案分成了很多的page，一個對象可以儲存在多個page上面，但一個page上不能被多個對象共享，vm-page-size是要根據存儲的 資料大小來設定的，作者建議如果存儲很多小對象，page大小最好設定為32或者64bytes；如果存儲很大大對象，則可以使用更大的page，如果不 确定，就使用預設值

     vm-page-size 32

25. 設定swap檔案中的page數量，由于頁表（一種表示頁面空閑或使用的bitmap）是在放在記憶體中的，，在磁盤上每8個pages将消耗1byte的記憶體。

     vm-pages 134217728

26. 設定通路swap檔案的線程數,最好不要超過機器的核數,如果設定為0,那麼所有對swap檔案的操作都是串行的，可能會造成比較長時間的延遲。預設值為4

     vm-max-threads 4

27. 設定在向用戶端應答時，是否把較小的包合并為一個包發送，預設為開啟

    glueoutputbuf yes

28. 指定在超過一定的數量或者最大的元素超過某一臨界值時，采用一種特殊的雜湊演算法

    hash-max-zipmap-entries 64

    hash-max-zipmap-value 512

29. 指定是否激活重置哈希，預設為開啟（後面在介紹Redis的雜湊演算法時具體介紹）

    activerehashing yes

30. 指定包含其它的配置檔案，可以在同一主機上多個Redis執行個體之間使用同一份配置檔案，而同時各個執行個體又擁有自己的特定配置檔案

    include /path/to/local.conf

二、redis-sentinel.conf配置項說明如下：

1. sentinel監聽端口，預設是26379，可以修改。

port 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

---------------------