redis.conf參數設定檔詳解

標籤：redis參數詳解

Redis是一個應用非常廣泛的高效能Key-Value型資料庫，與memcached類似，但功能更加強大！ 
本文將按照不同功能模組的方式，依次對各個功能模組的配置參數進行詳細介紹。

GENERAL

./redis-server /path/to/redis.conf 按照指定的設定檔啟動 
include /path/to/other.conf 包含其它的redis設定檔 
daemonize yes 啟用後台守護進程運行模式 
pidfile /var/run/redis.pid redis啟動後的進程ID儲存檔案 
port 6379 指定使用的連接埠號碼 
bind IP 監聽指定的網路介面 
unixsocket /tmp/redis.sock 指定監聽的socket，適用於unix環境 
timeout N 用戶端空閑N秒後中斷連線，參數0表示不啟用 
loglevel notice 指定伺服器資訊顯示的等級，4個參數分別為debug\verbose\notice\warning 
logfile “” 指定記錄檔，預設是使用系統的標準輸出 
syslog-enabled no 是否啟用將記錄記載到系統日誌功能，預設為不啟用 
syslog-ident redis 若啟用日誌記錄，則需要設定日誌記錄的身份 
syslog-facility local0 若啟用日誌記錄，則需要設定日誌facility，可取值範圍為local0~local7，表示不同的記錄層級 
databases 16 設定資料庫的數量，預設啟動時使用DB0，使用“select <dbid>”可以更換資料庫 
tcp-backlog 511 此參數確定TCP串連中已完成隊列（3次握手之後）的長度，應小於Linux系統的/proc/sys/net/core/somaxconn的值，此選項預設值為511，而Linux的somaxconn預設值為128，當並發量比較大且用戶端反應緩慢的時候，可以同時提高這兩個參數。 
tcp-keepalive 0 指定ACKs的時間周期，單位為秒，值非0的情況表示將周期性的檢測用戶端是否可用，預設值為60秒。

SNAPSHOTTING

資料儲存頻率： 
save 900 1 900秒後儲存，至少有1個key被更改時才會觸發 
save 300 10 300秒後儲存，至少有10個key被更改時才會觸發 
save 60 10000 60秒後儲存，至少有10000個key被更改時才會觸發

stop-writes-on-bgsave-error yes 最近一次save操作失敗則停止寫操作 
rdbcompression yes 啟用壓縮 
rdbchecksum yes 啟用CRC64校正碼，當然這個會影響一部份效能 
dbfilename dump.rdb 指定儲存資料的檔案名稱 
dir ./ 指定工作目錄，rdb檔案和aof檔案都會存放在這個目錄中，預設為目前的目錄

SECURITY

requirepass foobared 有slave端串連時是否要求輸入密碼驗證

LIMITS

maxclients 10000 同一時間內最大clients串連的數量，超過數量的串連會返回一個錯誤資訊 
maxmemory <bytes> 設定最大記憶體 
如果記憶體使用量量到達了最大記憶體設定，有6種處理方法：

volatile-lru -> remove the key with an expire set using an LRU algorithmallkeys-lru -> remove any key according to the LRU algorithmvolatile-random -> remove a random key with an expire setallkeys-random -> remove a random key, any keyvolatile-ttl -> remove the key with the nearest expire time (minor TTL)noeviction -> don‘t expire at all, just return an error on write operations123456123456

預設的設定是 maxmemory-policy noeviction 
maxmemory-samples 5 LRU演算法檢查的keys個數

APPEND ONLY MODE

appendonly yes 啟用AOF模式 
appendfilename “appendonly.aof” 設定AOF記錄的檔案名稱

向磁碟進行資料刷寫的頻率，有3個選項： 
always 有新資料則馬上刷寫，速度慢但可靠性高 
everysec 每秒鐘刷寫一次，折衷方法，所謂的redis可以只丟失1秒鐘的資料就是源於此處 
no 按照OS自身的刷寫策略來進行，速度最快 
使用選項來進行設定 appendfsync everysec

no-appendfsync-on-rewrite no 當主進程在進行向磁碟的寫操作時，將會阻止其它的fsync調用 
auto-aof-rewrite-percentage 100 aof檔案觸發自動rewrite的百分比，值為0則表示禁用自動rewrite 
auto-aof-rewrite-min-size 64mb aof檔案觸發自動rewrite的最小檔案size 
aof-load-truncated yes 是否載入不完整的aof檔案來進行啟動

LUA SCRIPTING

lua-time-limit 5000 設定lua指令碼的最大已耗用時間，單位為毫秒

EVENT NOTIFICATION

notify-keyspace-events “” 事件通知，預設不啟用，具體參數查看設定檔

REPLICATION

Redis的主從複製採用非同步方式進行。 
如果同步串連時slave端短暫的與master端斷開了串連，那串連恢複後允許slave端與master端進行一次局部的再同步。 
主從複製是自動進行的，並不需要使用者的介入，slave端會自動嘗試重連master並進行資料同步。 
slaveof <master ip> <master port> 設定master端的IP與連接埠資訊 
masterauth <master-password> 如果master端啟用了密碼保護（requirepass），那slave端就需要配置此選項 
slave-serve-stale-data yes 當slave端在主從複製的過程中與master端斷開了串連，此時有2種處理方法：一種是繼續提供服務即使資料可能不是最新的，另一種是對請求返回一個錯誤資訊，預設配置是繼續提供服務 
slave-read-only yes 自redis 2.6版本開始，slave端預設為readonly

主從同步支援兩種策略，即disk和socket方式（socket方式尚不完善，還處於實驗階段）。 
新的slave端和重連的salve端不允許去繼續同步進程，這被稱之為“完全同步”。 
一個RDB檔案從master端傳到slave端，分為兩種情況： 
1、支援disk：master端將RDB file寫到disk，稍後再傳送到slave端； 
2、無磁碟diskless：master端直接將RDB file傳到slave socket，不需要與disk進行互動。 
無磁碟diskless方式適合磁碟讀寫速度慢但網路頻寬非常高的環境。 
repl-diskless-sync no 預設不使用diskless同步方式 
repl-diskless-sync-delay 5 無磁碟diskless方式在進行資料傳遞之前會有一個時間的延遲，以便slave端能夠進行到待傳送的目標隊列中，這個時間預設是5秒 
repl-ping-slave-period 10 slave端向server端發送pings的時間區間設定，預設為10秒 
repl-timeout 60 設定逾時時間 
repl-disable-tcp-nodelay no 是否啟用TCP_NODELAY，如果啟用則會使用少量的TCP包和頻寬去進行資料轉送到slave端，當然速度會比較慢；如果不啟用則傳輸速度比較快，但是會佔用比較多的頻寬。 
repl-backlog-size 1mb 設定backlog的大小，backlog是一個緩衝區，在slave端失連時存放要同步到slave的資料，因此當一個slave要重連時，經常是不需要完全同步的，執行局部同步就足夠了。backlog設定的越大，slave可以失連的時間就越長。 
repl-backlog-ttl 3600 如果一段時間後沒有slave串連到master，則backlog size的記憶體將會被釋放。如果值為0則表示永遠不釋放這部份記憶體。 
slave-priority 100 slave端的優先順序設定，值是一個整數，數字越小表示優先順序越高。當master故障時將會按照優先順序來選擇slave端進行恢複，如果值設定為0，則表示該slave永遠不會被選擇。 
min-slaves-to-write 3 
min-slaves-max-lag 10 設定當一個master端的可用slave少於N個，延遲時間大於M秒時，不接收寫操作。

REDIS CLUSTER

一個正常的redis執行個體是不能做為一個redis叢集的節點的，除非它是以一個叢集節點的方式進行啟動。 
cluster-enabled yes 配置redis做為一個叢集節點來啟動 
cluster-config-file node-6379.conf 每個叢集節點都有一個叢集設定檔，這個檔案不需要編輯，它由redis節點來建立和更新。每個redis節點的叢集設定檔不可以相同。 
cluster-node-timeout 15000 設定叢集節點逾時時間，如果超過了指定的逾時時間後仍不可達，則節點被認為是失敗狀態，單位為毫秒。

一個屬於失效的master端的slave，如果它的資料較舊，將不會啟動failover。 
現在來講並沒有一個簡單的方法去解決如何判定一個slave端的資料的時效性問題，所以可以執行以下兩個選擇： 
1、如果有多個slave可用於failover，它們會交換資訊以便選出一個最優的進行主從複製的offset，slave端會嘗試依據offset去擷取每個slave的rank，這樣在啟動failover時對每個slave的利用就與slave端的rank成正比。 
2、每個slave端和它的master端進行最後互動的時間，這可能是最近的ping或指令接收時間，或自與master端失連的過時時間。如果最近的互動時間太久，slave就不會嘗試去進行failover。 
第2點可以由使用者來進行調整，明確一個slave不會進行failover。自最近一次與master端進行互動，過時時間有一個計算公式： 
（node-timeout * slave-validity-factor）+repl-ping-slave-period 
一個比較大的slave-validity-factor參數能夠允許slave端使用比較舊的資料去failover它的master端，而一個比較小的值可能會阻止叢集去選擇slave端。 
為獲得最大的可用性，可以設定slave-validity-factor的值為0，這表示slave端將會一直去嘗試failover它的master端而不管它與master端的最後互動時間。 
cluster-slave-validity-factor 10 預設值為10

叢集中的slave可以遷移到那些沒有可用slave的master端，這提升了叢集處理故障的能力。畢竟一個沒有slave的master端如果發生了故障是沒有辦法去進行failover的。 
要將一個slave遷移到別的master，必須這個slave的原master端有至少給定數目的可用slave才可以進行遷移，這個給定的數目由migration barrier參數來進行設定，預設值為1，表示這個要進行遷移的slave的原master端應該至少還有1個可用的slave才允許其進行遷移，要禁用這個功能只需要將此參數設定為一個非常大的值。 
cluster-migration-barrier 1

預設情況下當redis叢集節點發現有至少一個hashslot未被covered時將會停止接收查詢。 
這種情況下如果有一部份的叢集down掉了，那整個叢集將變得不可用。 
叢集將會在所有的slot重新covered之後自動回復可用。 
若想要設定叢集在部份key space沒有cover完成時繼續去接收查詢，就將參數設定為no。 
cluster-require-full-coverage yes

SLOW LOG

redis的slow log是一個系統OS進行的記錄查詢，它是超過了指定的執行時間的。執行時間不包括類似與client進行互動或發送回複等I/O操作，它只是實際執行指令的時間。 
有2個參數可以配置，一個用來告訴redis執行時間，這個時間是微秒級的（1秒=1000000微秒），這是為了不遺漏命令。另一個參數是設定slowlog的長度，當一個新的命令被記錄時，最舊的命令將會從命令記錄隊列中移除。 
slowlog-log-slower-than 10000 
slowlog-max-len 128 
可以使用“slowlog reset”命令來釋放slowlog佔用的記憶體。

LATENCY MONITOR

latency-monitor-threshold 0 延遲監控，用於記錄等於或超過了指定時間的操作，預設是關閉狀態，即值為0。

ADVANCED CONFIG

當條目數量較少且最大不會超過給定閥值時，雜湊編碼將使用一個很高效的記憶體資料結構，閥值由以下參數來進行配置。 
hash-max-ziplist-entries 512 
hash-max-ziplist-value 64

與雜湊類似，少量的lists也會通過一個指定的方式去編碼從而節省更多的空間，它的閥值通過以下參數來進行配置。 
list-max-ziplist-entries 512 
list-max-ziplist-value 64

集合sets在一種特殊的情況時有指定的編碼方式，這種情況是集合由一組10進位的64位有符號整數範圍內的數字組成的情況。以下選項可以設定集合使用這種特殊編碼方式的size限制。 
set-max-intset-entries 512

與雜湊和列表類似，有序集合也會使用一種特殊的編碼方式來節省空間的，這種特殊的編碼方式只用於這個有序集合的長度和元素均低於以下參數設定的值時。 
zset-max-ziplist-entries 128 
zset-max-ziplist-value 64

hll-sparse-max-bytes 3000 設定HyeperLogLog的位元組數限制，這個值通常在0~15000之間，預設為3000，基本不超過16000 
activerehashing yes redis將會在每秒中抽出10毫秒來對主字典進行重新散列化處理，這有助於儘可能的釋放記憶體

因為某些原因，client不能足夠快的從server讀取資料，那client的輸出緩衝限制可能會使client失連，這個限制可用於3種不同的client種類，分別是：normal、slave和pubsub。 
進行設定的格式如下：

client-output-buffer-limit <class><hard limit><soft limit><soft seconds>11

如果達到hard limit那client將會立即失連。 
如果達到soft limit那client將會在soft seconds秒之後失連。 
參數soft limit < hard limit。 
client-output-buffer-limit normal 0 0 0 
client-output-buffer-limit slave 256mb 64mb 60 
client-output-buffer-limit pubsub 32mb 8mb 60

redis使用一個內部程式來處理背景工作，例如關閉逾時的client串連，清除到期的key等等。它並不會同時處理所有的任務，redis通過指定的hz參數去檢查和執行任務。 
hz預設設為10，提高它的值將會佔用更多的cpu，當然相應的redis將會更快的處理同時到期的許多key，以及更精確的去處理逾時。 
hz的取值範圍是1~500，通常不建議超過100，只有在請求延時非常低的情況下可以將值提升到100。 
hz 10

當一個子進程要改寫AOF檔案，如果以下選項啟用，那檔案將會在每產生32MB資料時進行同步，這樣提交增量檔案到磁碟時可以避免出現比較大的延遲。 
aof-rewrite-incremental-fsync yes

本文出自 “夢想照進現實” 部落格，請務必保留此出處http://lookingdream.blog.51cto.com/5177800/1883867

redis.conf參數設定檔詳解