Redis設定檔詳解，redis設定檔

Redis設定檔詳解，redis設定檔
# Redis 設定檔
# 當配置中需要配置記憶體大小時，可以使用 1k, 5GB, 4M 等類似的格式，其轉換方式如下(不區分大小寫)
#
# 1k => 
1000 bytes
# 1kb => 1024 bytes
# 1m => 1000000 bytes
# 1mb => 
1024*1024 bytes
# 1g => 1000000000 bytes
# 1gb => 1024*1024*1024 
bytes
#
# 記憶體配置大小寫是一樣的.比如 1gb 1Gb 1GB 1gB
# daemonize no 預設情況下，redis不是在後台啟動並執行，如果需要在後台運行，把該項的值更改為yes
daemonize 
yes
# 當redis在後台啟動並執行時候，Redis預設會把pid檔案放在/var/run/redis.pid，你可以配置到其他地址。
# 
當運行多個redis服務時，需要指定不同的pid檔案和連接埠
pidfile /var/run/redis.pid
# 指定redis啟動並執行連接埠，預設是6379
port 6379
# 指定redis只接收來自於該IP地址的請求，如果不進行設定，那麼將處理所有請求，
# 在生產環境中最好設定該項
# bind 
127.0.0.1
# Specify the path for the unix socket that will be used to listen for
# 
incoming connections. There is no default, so Redis will not listen
# on a 
unix socket when not specified.
#
# unixsocket /tmp/redis.sock
# 
unixsocketperm 755
# 設定用戶端串連時的逾時時間，單位為秒。當用戶端在這段時間內沒有發出任何指令，那麼關閉該串連
# 0是關閉此設定
timeout 
0
# 指定日誌記錄層級
# Redis總共支援四個層級：debug、verbose、notice、warning，預設為verbose
# 
debug  記錄很多資訊，用於開發與測試
# varbose 有用的資訊，不像debug會記錄那麼多
# 
notice 普通的verbose，常用於生產環境
# warning 只有非常重要或者嚴重的資訊會記錄到日誌
loglevel 
debug
# 配置log檔案地址
# 預設值為stdout，標準輸出，若後台模式會輸出到/dev/null
#logfile 
stdout
logfile /var/log/redis/redis.log
# To enable logging to the system logger, just set 'syslog-enabled' to 
yes,
# and optionally update the other syslog parameters to suit your 
needs.
# syslog-enabled no
# Specify the syslog identity.
# syslog-ident redis
# Specify the syslog facility.  Must be USER or between LOCAL0-LOCAL7.
# 
syslog-facility local0
# 可用資料庫數
# 預設值為16，預設資料庫為0，資料庫範圍在0-（database-1）之間
databases 16
################################ 快照  
#################################
#
# 儲存資料到磁碟，格式如下:
#
#   save 
<seconds> <changes>
#
#   
指出在多長時間內，有多少次更新操作，就將資料同步到資料檔案rdb。
#   相當於條件觸發抓取快照，這個可以多個條件配合
#   
#   
比如預設設定檔中的設定，就設定了三個條件
#
#   save 900 1  900秒內至少有1個key被改變
#   save 300 
10  300秒內至少有300個key被改變
#   save 60 10000  60秒內至少有10000個key被改變
save 900 1
save 300 10
save 60 10000
# 儲存至本機資料庫時（持久化到rdb檔案）是否壓縮資料，預設為yes
rdbcompression yes
# 本地持久化資料庫檔案名，預設值為dump.rdb
dbfilename dump.rdb
# 工作目錄
#
# 資料庫鏡像備份的檔案放置的路徑。
# 
這裡的路徑跟檔案名稱要分開配置是因為redis在進行備份時，先會將當前資料庫的狀態寫入到一個臨時檔案中，等備份完成時，
# 
再把該該臨時檔案替換為上面所指定的檔案，而這裡的臨時檔案和上面所配置的備份檔案都會放在這個指定的路徑當中。
#
# 
AOF檔案也會存放在這個目錄下面
#
# 注意這裡必須制定一個目錄而不是檔案
dir ./
################################# 複製 
#################################
# 主從複製. 設定該資料庫為其他資料庫的從資料庫.
# 
設定當本機為slav服務時，設定master服務的IP地址及連接埠，在Redis啟動時，它會自動從master進行資料同步
#
# slaveof 
<masterip> <masterport>
# 當master服務設定了密碼保護時(用requirepass制定的密碼)
# slav服務串連master的密碼
#
# 
masterauth <master-password>

# 當從庫同主機失去串連或者複製進行中，從機庫有兩種運行方式：
#
# 1) 
如果slave-serve-stale-data設定為yes(預設設定)，從庫會繼續相應用戶端的請求
#
# 2) 
如果slave-serve-stale-data是指為no，出去INFO和SLAVOF命令之外的任何請求都會返回一個
#    錯誤"SYNC with 
master in progress"
#
slave-serve-stale-data yes
# 從庫會按照一個時間間隔向主庫發送PINGs.可以通過repl-ping-slave-period設定這個時間間隔，預設是10秒
#
# 
repl-ping-slave-period 10
# repl-timeout 設定主庫批量資料轉送時間或者ping回複時間間隔，預設值是60秒
# 
一定要確保repl-timeout大於repl-ping-slave-period
# repl-timeout 60
################################## 安全 
###################################
# 設定用戶端串連後進行任何其他指定前需要使用的密碼。
# 
警告：因為redis速度相當快，所以在一台比較好的伺服器下，一個外部的使用者可以在一秒鐘進行150K次的密碼嘗試，這意味著你需要指定非常非常強大的密碼來防止暴力破解
#
# 
requirepass foobared
# 命令重新命名.
#
# 在一個共用環境下可以重新命名相對危險的命令。比如把CONFIG重名為一個不容易猜測的字元。
#
# 
舉例:
#
# rename-command CONFIG 
b840fc02d524045429941cc15f59e41cb7be6c52
#
# 
如果想刪除一個命令，直接把它重新命名為一個Null 字元""即可，如下：
#
# rename-command CONFIG ""
################################### 約束 
####################################
# 設定同一時間最大用戶端串連數，預設無限制，Redis可以同時開啟的用戶端串連數為Redis進程可以開啟的最大檔案描述符數，
# 如果設定 
maxclients 0，表示不作限制。
# 當用戶端串連數到達限制時，Redis會關閉新的串連並向用戶端返回max number of clients 
reached錯誤資訊
#
# maxclients 128
# 指定Redis最大記憶體限制，Redis在啟動時會把資料載入到記憶體中，達到最大記憶體後，Redis會先嘗試清除已到期或即將到期的Key
# 
Redis同時也會移除空的list對象
#
# 
當此方法處理後，仍然到達最大記憶體設定，將無法再進行寫入操作，但仍然可以進行讀取操作
#
# 
注意：Redis新的vm機制，會把Key存放記憶體，Value會存放在swap區
#
# 
maxmemory的設定比較適合於把redis當作於類似memcached的緩衝來使用，而不適合當做一個真實的DB。
# 
當把Redis當做一個真實的資料庫使用的時候，記憶體使用量將是一個很大的開銷
# maxmemory <bytes>
# 當記憶體達到最大值的時候Redis會選擇刪除哪些資料？有五種方式可供選擇
#
# volatile-lru -> 
利用LRU演算法移除設定過到期時間的key (LRU:最近使用 Least Recently Used )
# allkeys-lru -> 
利用LRU演算法移除任何key
# volatile-random -> 移除設定過到期時間的隨機key
# 
allkeys->random -> remove a random key, any key
# volatile-ttl -> 
移除即將到期的key(minor TTL)
# noeviction -> 不移除任何可以，只是返回一個寫錯誤
#
# 
注意：對於上面的策略，如果沒有合適的key可以移除，當寫的時候Redis會返回一個錯誤
#
#       寫命令包括: set setnx 
setex append
#       incr decr rpush lpush rpushx lpushx linsert lset 
rpoplpush sadd
#       sinter sinterstore sunion sunionstore sdiff sdiffstore 
zadd zincrby
#       zunionstore zinterstore hset hsetnx hmset hincrby incrby 
decrby
#       getset mset msetnx exec sort
#
# 預設是:
#
# 
maxmemory-policy volatile-lru
# LRU 和 minimal TTL 演算法都不是精準的演算法，但是相對精確的演算法(為了節省記憶體)，隨意你可以選擇樣本大小進行檢測。
# 
Redis預設的灰選擇3個樣本進行檢測，你可以通過maxmemory-samples進行設定
#
# maxmemory-samples 
3
############################## AOF ###############################

# 
預設情況下，redis會在後台非同步把資料庫鏡像備份到磁碟，但是該備份是非常耗時的，而且備份也不能很頻繁，如果發生諸如拉閘限電、拔插頭等狀況，那麼將造成比較大範圍的資料丟失。
# 
所以redis提供了另外一種更加高效的Database Backup及災難恢複方式。
# 開啟append 
only模式之後，redis會把所接收到的每一次寫操作請求都追加到appendonly.aof檔案中，當redis重新啟動時，會從該檔案恢複出之前的狀態。
# 
但是這樣會造成appendonly.aof檔案過大，所以redis還支援了BGREWRITEAOF指令，對appendonly.aof 進行重新整理。
# 
你可以同時開啟asynchronous dumps 和 AOF
appendonly no
# AOF檔案名稱 (預設: "appendonly.aof")
# appendfilename appendonly.aof
# Redis支援三種同步AOF檔案的策略:
#
# no: 不進行同步，系統去操作 . Faster.
# always: 
always表示每次有寫操作都進行同步. Slow, Safest.
# everysec: 表示對寫操作進行累積，每秒同步一次. 
Compromise.
#
# 預設是"everysec"，按照速度和安全折中這是最好的。
# 
如果想讓Redis能更高效的運行，你也可以設定為"no"，讓作業系統決定什麼時候去執行
# 
或者相反想讓資料更安全你也可以設定為"always"
#
# 如果不確定就用 "everysec".
# appendfsync always
appendfsync everysec
# appendfsync no
# AOF原則設定為always或者everysec時，幕後處理進程(後台儲存或者AOF日誌重寫)會執行大量的I/O操作
# 
在某些Linux配置中會阻止過長的fsync()請求。注意現在沒有任何修複，即使fsync在另外一個線程進行處理
#
# 
為了減緩這個問題，可以設定下面這個參數no-appendfsync-on-rewrite
#
# This means that while 
another child is saving the durability of Redis is
# the same as "appendfsync 
none", that in pratical terms means that it is
# possible to lost up to 30 
seconds of log in the worst scenario (with the
# default Linux 
settings).
#
# If you have latency problems turn this to "yes". Otherwise 
leave it as
# "no" that is the safest pick from the point of view of 
durability.
no-appendfsync-on-rewrite no
# Automatic rewrite of the append only file.
# AOF 自動重寫
# 
當AOF檔案增長到一定大小的時候Redis能夠調用 BGREWRITEAOF 對記錄檔進行重寫
#
# 
它是這樣工作的：Redis會記住上次進行些日誌後檔案的大小(如果從開機以來還沒進行過重寫，那日子大小在開機的時候確定)
#
# 
基礎大小會同現在的大小進行比較。如果現在的大小比基礎大小大制定的百分比，重寫功能將啟動
# 
同時需要指定一個最小大小用於AOF重寫，這個用於阻止即使檔案很小但是增長幅度很大也去重寫AOF檔案的情況
# 設定 percentage 
為0就關閉這個特性
auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb
################################## SLOW LOG 
###################################
# Redis Slow Log 記錄超過特定執行時間的命令。執行時間不包括I/O計算比如串連用戶端，返回結果等，只是命令執行時間
#
# 
可以通過兩個參數設定slow log：一個是告訴Redis執行超過多少時間被記錄的參數slowlog-log-slower-than(微妙)，
# 
另一個是slow log 的長度。當一個新命令被記錄的時候最早的命令將被從隊列中移除
# 下面的時間以微妙微單位，因此1000000代表一分鐘。
# 
注意制定一個負數將關閉慢日誌，而設定為0將強制每個命令都會記錄
slowlog-log-slower-than 10000
# 對日誌長度沒有限制，只是要注意它會消耗記憶體
# 可以通過 SLOWLOG RESET 
回收被慢日誌消耗的記憶體
slowlog-max-len 1024
################################ VM ###############################
### WARNING! Virtual Memory is deprecated in Redis 2.4
### The use of 
Virtual Memory is strongly discouraged.
# Virtual Memory allows Redis to work with datasets bigger than the 
actual
# amount of RAM needed to hold the whole dataset in memory.
# In 
order to do so very used keys are taken in memory while the other keys
# are 
swapped into a swap file, similarly to what operating systems do
# with 
memory pages.
#
# To enable VM just set 'vm-enabled' to yes, and set the 
following three
# VM parameters accordingly to your needs.
vm-enabled no
# vm-enabled yes
# This is the path of the Redis swap file. As you can guess, swap 
files
# can't be shared by different Redis instances, so make sure to use a 
swap
# file for every redis process you are running. Redis will complain if 
the
# swap file is already in use.
#
# The best kind of storage for the 
Redis swap file (that's accessed at random)
# is a Solid State Disk 
(SSD).
#
# *** WARNING *** if you are using a shared hosting the default 
of putting
# the swap file under /tmp is not secure. Create a dir with access 
granted
# only to Redis user and configure Redis to create the swap file 
there.
vm-swap-file /tmp/redis.swap
# vm-max-memory configures the VM to use at max the specified amount 
of
# RAM. Everything that deos not fit will be swapped on disk *if* possible, 
that
# is, if there is still enough contiguous space in the swap 
file.
#
# With vm-max-memory 0 the system will swap everything it can. Not 
a good
# default, just specify the max amount of RAM you can in bytes, but 
it's
# better to leave some margin. For instance specify an amount of 
RAM
# that's more or less between 60 and 80% of your free 
RAM.
vm-max-memory 0
# Redis swap files is split into pages. An object can be saved using 
multiple
# contiguous pages, but pages can't be shared between different 
objects.
# So if your page is too big, small objects swapped out on disk will 
waste
# a lot of space. If you page is too small, there is less space in the 
swap
# file (assuming you configured the same number of total swap file 
pages).
#
# If you use a lot of small objects, use a page size of 64 or 32 
bytes.
# If you use a lot of big objects, use a bigger page size.
# If 
unsure, use the default :)
vm-page-size 32
# Number of total memory pages in the swap file.
# Given that the page 
table (a bitmap of free/used pages) is taken in memory,
# every 8 pages on 
disk will consume 1 byte of RAM.
#
# The total swap size is vm-page-size * 
vm-pages
#
# With the default of 32-bytes memory pages and 134217728 pages 
Redis will
# use a 4 GB swap file, that will use 16 MB of RAM for the page 
table.
#
# It's better to use the smallest acceptable value for your 
application,
# but the default is large in order to work in most 
conditions.
vm-pages 134217728
# Max number of VM I/O threads running at the same time.
# This threads 
are used to read/write data from/to swap file, since they
# also encode and 
decode objects from disk to memory or the reverse, a bigger
# number of 
threads can help with big objects even if they can't help with
# I/O itself 
as the physical device may not be able to couple with many
# reads/writes 
operations at the same time.
#
# The special value of 0 turn off threaded 
I/O and enables the blocking
# Virtual Memory 
implementation.
vm-max-threads 4
############################### ADVANCED CONFIG 
###############################
# 當hash中包含超過指定元素個數並且最大的元素沒有超過臨界時，
# 
hash將以一種特殊的編碼方式（大大減少記憶體使用量）來儲存，這裡可以設定這兩個臨界值
# Redis 
Hash對應Value內部實際就是一個HashMap，實際這裡會有2種不同實現，
# 
這個Hash的成員比較少時Redis為了節省記憶體會採用類似一維數組的方式來緊湊儲存，而不會採用真正的HashMap結構，對應的value 
redisObject的encoding為zipmap,
# 
當成員數量增大時會自動轉成真正的HashMap,此時encoding為ht。
hash-max-zipmap-entries 
512
hash-max-zipmap-value 64
# list資料類型多少節點以下會採用去指標的緊湊儲存格式。
# 
list資料類型節點值大小小於多少位元組會採用緊湊儲存格式。
list-max-ziplist-entries 
512
list-max-ziplist-value 64
# set資料類型內部資料如果全部是數值型，且包含多少節點以下會採用緊湊格式儲存。
set-max-intset-entries 
512
# zsort資料類型多少節點以下會採用去指標的緊湊儲存格式。
# 
zsort資料類型節點值大小小於多少位元組會採用緊湊儲存格式。
zset-max-ziplist-entries 
128
zset-max-ziplist-value 64
# Redis將在每100毫秒時使用1毫秒的CPU時間來對redis的hash表進行重新hash，可以降低記憶體的使用
#
# 
當你的使用情境中，有非常嚴格的即時性需要，不能夠接受Redis時不時的對請求有2毫秒的延遲的話，把這項配置為no。
#
# 
如果沒有這麼嚴格的即時性要求，可以設定為yes，以便能夠儘可能快的釋放記憶體
activerehashing yes
################################## INCLUDES 
###################################
# 指定包含其它的設定檔，可以在同一主機上多個Redis執行個體之間使用同一份設定檔，而同時各個執行個體又擁有自己的特定設定檔# 
include /path/to/local.conf
# include /path/to/other.conf