Redis 相关运维操作

brownswan 发布于4月前

背景

Redis作为目前全球最流行的KV存储,除了使用之外,还需要做好日常的运维工作。关于运维相关的工作,本文从以下方面进行介绍说明(Redis5.0以上):

  • 内存方面
  • 客户端连接方面
  • 工具方面

说明

内存方面

说明: 第一个值是 memory stats 提供,第二个值是 info memory 提供

  • 服务内存相关(单位:字节)

  1. 消耗的最大峰值内存

    peak.allocated
    used_memory_peak
  2. 最大分配使用内存

    total.allocated
    used_memory
  3. 启动时消耗的初始内存

    startup.allocated
    used_memory_startup
  4. 复制积压的内存

    replication.backlog
    repl_backlog_size
  5. 数据占用内存

    dataset.bytes
    used_memory_dataset
  6. 管理内部数据结构的所有开销的内存

    -- 包括startup.allocated, replication.backlog, clients.slaves, clients.normal, aof.buffer及用于管理Redis键空间的内部数据结构的总和
    overhead.total
    used_memory_overhead
  7. 当前和重写AOF缓冲区内存

    aof.buffer
    mem_aof_buffer
  8. 所有副本开销(输出和查询缓冲区,连接上下文)的总内存

    clients.slaves
    mem_clients_slaves
  9. 所有客户端开销(输出和查询缓冲区,连接上下文)的总内存

    clients.normal
    mem_clients_normal
  10. Lua脚本的缓存开销的总内存

    lua.caches
    used_memory_lua
  11. 服务内存占用物理内存比例

    rss-overhead.ratio
    rss_overhead_ratio

更多内存相关的可以看 memory stats

info memory

 

  • Key内存相关:查看单个key的大小

  1. 命令行查看
    ①  DEBUG OBJECT (redis4.0之前)命令估算key的内存使用(字段serializedlength),但因为相差太大,参考价值不高

    > get b
    "cbd"
    
    > DEBUG OBJECT b
    Value at:0x7f24e2b33d40 refcount:1 encoding:embstr serializedlength:4 lru:445248 lru_seconds_idle:3

    ②  MEMORY USAGE   [SAMPLES count] (redis4.0之后)命令估算key的value实际使用内存,不包含key的大小和过期属性的内存占用

    > get b
    "cbd"
    > MEMORY USAGE b
    (integer) 48

    对于集合的数据类型(除string外), usage子命令采用类似LRU SAMPLES的抽样方式,默认抽样5个(count)元素求平均得出实际内存占用,所以计算是近似值。可以指定抽样的SAMPLES个数,如:生成一个100w个字段的hash键:hkey, 每字段的value长度是从1~1024字节的随机值:

    > hlen hkey    // hkey有100w了字段,每个字段的value长度介入1~1024个字节
    (integer) 1000000
    > MEMORY usage hkey   //默认SAMPLES为5,分析hkey键内存占用521588753字节
    (integer) 521588753
    > MEMORY usage hkey SAMPLES  1000 //指定SAMPLES为1000,分析hkey键内存占用617977753字节
    (integer) 617977753
    > MEMORY usage hkey SAMPLES  10000 //指定SAMPLES为10000,分析hkey键内存占用624950853字节
    (integer) 624950853

    这是使用抽样求平均的算法,要想获取key较精确的内存值,就指定更大SAMPLES个数。但并不越大越好,因为memory usage越大其占用cpu时间分片就大。SAMPLES 为0则会对所有值进行采样。memory usage时间复杂度,和指定的SAMPLES数有关。

  2. rdb工具分析rdb文件,获得某个key的实际使用内存

    Redis RDB 分析工具 rdbtools 说明

客户端连接方面

说明:client 是一个客户端的操作方法,可以查看当前ID、当前连接信息等,具体的命令可以看 官网

> client help
 1) CLIENT <subcommand> arg arg ... arg. Subcommands are:
 -- 返回当前的连接ID,可用于kill
 2) ID                     -- Return the ID of the current connection.
 -- 返回当前连接的名字
 3) GETNAME                -- Return the name of the current connection.
 -- Kill 来自某个地址的连接
 4) KILL <ip:port>         -- Kill connection made from <ip:port>.
 -- Kill 连接
 5) KILL <option> <value> [option value ...] -- Kill connections. Options are:
 -- Kill 来自某个地址的连接
 6)      ADDR <ip:port>                      -- Kill connection made from <ip:port>
 -- 按类型Kill连接
 7)      TYPE (normal|master|replica|pubsub) -- Kill connections by type.
 -- Kill通过该用户身份验证的连接
 8)      USER <username>   -- Kill connections authenticated with such user.
 -- 跳过Kill当前连接,默认yes
 9)      SKIPME (yes|no)   -- Skip killing current connection (default: yes).
 -- 返回客户端连接的信息
10) LIST [options ...]     -- Return information about client connections. Options:
 -- 返回指定类型的客户端
11)   TYPE (normal|master|replica|pubsub) -- Return clients of specified type.
 -- 暂停所有客户端<timout>毫秒
12) PAUSE <timeout>        -- Suspend all Redis clients for <timout> milliseconds.
 -- 控制服务器对当前客户端的回复,ON:默认,回复;OFF:不回复客;SKIP:跳过回复
13) REPLY (on|off|skip)    -- Control the replies sent to the current connection.
-- 给当前连接设置名字
14) SETNAME <name>         -- Assign the name <name> to the current connection.
-- 取消指定的被阻止的客户端 
15) UNBLOCK <clientid> [TIMEOUT|ERROR] -- Unblock the specified blocked client.
-- 客户端缓存启用key跟踪
16) TRACKING (on|off) [REDIRECT <id>] [BCAST] [PREFIX first] [PREFIX second] [OPTIN] [OPTOUT]... -- Enable client keys tracking for client side caching.
-- 启用跟踪时,返回重定向到的客户端ID
17) GETREDIR               -- Return the client ID we are redirecting to when tracking is enabled.
-- 启用跟踪时,控制在连接执行的下一个命令中对键的跟踪(在连接中设置一个状态,该状态仅对下一个命令执行有效)
18) CACHING (YES|NO)     -- Basically the command sets a state in the connection, that is valid only for the next command execution, that will modify the behavior of client tracking.
  • CLIENT ID :返回当前连接的ID

    -- ID值单调递增,不重复
    > CLIENT ID
    (integer) 701
  • CLIENT GETNAME :返回当前连接由 CLIENT SETNAME 设置的名字

    > CLIENT GETNAME
    "zjy"
  • CLIENT SETNAME :为当前连接分配一个名字

    -- client list 中的name会显示
    > CLIENT SETNAME zjy
    OK
  • CLIENT LIST: 返回所有连接到服务器的客户端信息和统计数据

    -- 返回所有
    > CLIENT LIST
    id=701 addr=192.168.163.134:52722 fd=16 name=zjy age=1225 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 obl=0 oll=0 omem=0 events=r cmd=client user=default
    id=598 addr=192.168.163.134:36327 fd=12 name= age=9321 idle=1 flags=S db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=0 obl=0 oll=0 omem=0 events=r cmd=replconf user=replica-user
    id=703 addr=192.168.163.1:64583 fd=9 name= age=115 idle=81 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=0 obl=0 oll=0 omem=0 events=r cmd=auth user=dba
    
    -- 返回指定类型:normal|master|replica|pubsub
    > CLIENT LIST type replica
    id=598 addr=192.168.163.134:36327 fd=12 name= age=9341 idle=0 flags=S db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=0 obl=0 oll=0 omem=0 events=r cmd=replconf user=replica-user
    
    -- 返回指定类型:normal|master|replica|pubsub
    > CLIENT LIST type normal
    id=701 addr=192.168.163.134:52722 fd=16 name=zjy age=1254 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=48 qbuf-free=32720 obl=0 oll=0 omem=0 events=r cmd=client user=default
    id=703 addr=192.168.163.1:64583 fd=9 name= age=144 idle=110 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=0 obl=0 oll=0 omem=0 events=r cmd=auth user=dba

    格式如下:

    1. 每个已连接客户端对应一行(以 LF 分割)
    2. 每行字符串由一系列 属性=值(property=value) 形式的域组成,每个域之间以空格分开。

    各字段的含义:

    id: 唯一的客户端ID
    addr: 客户端的地址和端口
    fd: 套接字所使用的文件描述符
    age: 以秒计算的已连接时长
    idle: 以秒计算的空闲时长
    flags: 客户端 flag:
      -- O: 客户端是 MONITOR 模式下的附属节点(slave)
      -- S: 客户端是一般模式下(normal)的附属节点
      -- M: 客户端是主节点(master)
      -- x: 客户端正在执行事务
      -- b: 客户端正在等待阻塞事件
      -- i: 客户端正在等待 VM I/O 操作(已废弃)
      -- d: 一个受监视(watched)的键已被修改, EXEC 命令将失败
      -- c: 在将回复完整地写出之后,关闭链接
      -- u: 客户端未被阻塞(unblocked)
      -- U: 通过Unix套接字连接的客户端
      -- r: 客户端是只读模式的集群节点
      -- A: 尽可能快地关闭连接
      -- N: 未设置任何 flag
    db: 该客户端正在使用的数据库 ID
    sub: 已订阅频道的数量
    psub: 已订阅模式的数量
    multi: 在事务中被执行的命令数量
    qbuf: 查询缓冲区的长度(字节为单位, 0 表示没有分配查询缓冲区)
    qbuf-free: 查询缓冲区剩余空间的长度(字节为单位, 0 表示没有剩余空间)
    obl: 输出缓冲区的长度(字节为单位, 0 表示没有分配输出缓冲区)
    oll: 输出列表包含的对象数量(当输出缓冲区没有剩余空间时,命令回复会以字符串对象的形式被入队到这个队列里)
    omem: 输出缓冲区和输出列表占用的内存总量
    events: 文件描述符事件:
      -- r: 客户端套接字(在事件 loop 中)是可读的(readable)
      -- w: 客户端套接字(在事件 loop 中)是可写的(writeable)
    cmd: 最近一次执行的命令
    user: 连接的用户
  • CLIENT PAUSE :连接控制,可以将所有客户端的访问暂停给定的毫秒数(slaves的交互除外)

    -- 所有客户端暂停10秒
    > CLIENT PAUSE 10000
    OK

    场景:

    当需要升级一个实例时,管理员可以作如下操作:
    
    使用CLIENT PAUSE 暂停所有客户端
    等待数秒,让slaves节点处理完所有来自master的复制命令
    将一个salve节点切换为master
    重配客户端以来接新的master 节点
  • CLIENT KILL:按不同的属性 关闭连接:如id,user、addr:port

    -- list
    > client list
    id=598 addr=192.168.163.134:36327 fd=12 name= age=23517 idle=0 flags=S db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=0 obl=0 oll=0 omem=0 events=r cmd=replconf user=replica-user
    id=801 addr=192.168.163.134:53810 fd=13 name= age=208 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 obl=0 oll=0 omem=0 events=r cmd=client user=default
    id=803 addr=192.168.163.1:54934 fd=9 name= age=14 idle=14 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=0 obl=0 oll=0 omem=0 events=r cmd=auth user=dba
    id=804 addr=192.168.163.1:54935 fd=14 name= age=10 idle=7 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=0 obl=0 oll=0 omem=0 events=r cmd=client user=default
    
    -- 根据地址属性kill
    > CLIENT KILL addr 192.168.163.1:54935
    (integer) 1
    
    -- 根据用户kill
    > CLIENT KILL user dba
    (integer) 1
    
    -- 根据连接类型kill
    > CLIENT KILL type normal
    (integer) 1
    
    -- 是否kill当前操作的连接
    > CLIENT KILL type normal SKIPME no
    (integer) 1

    注意:Redis的单线程属性,不可能在客户端执行命令时杀掉它. 从客户端的角度看,永远无法杀死一个正在执行命令的连接。 但是当客户端发送下一条命令时会意识到连接已被关,原因为网络错误。

  • CLIENT UNBLOCK :解除客户端的阻塞

    -- Connection A (blocking connection):
    > CLIENT ID
    2934
    > BRPOP key1 key2 key3 0
    (client is blocked)
    
    ... Now we want to add a new key ...
    
    -- Connection B (control connection):
    > CLIENT UNBLOCK 2934
    1
    
    -- Connection A (blocking connection):
    ... BRPOP reply with timeout ...
    NULL
    
    > BRPOP key1 key2 key3 key4 0
    (client is blocked again)
  • CLIENT 

    REPLY :是否禁用redis服务器对当前客户端的回复响应

    -- 控制服务器是否将回复客户端的命令
    ON. 默认选项,回复客户端每条命令
    OFF. 不回复客户端命令
    SKIP. 跳过该命令的回复
    
    当执行命令设置为OFF或SKIP,设置命令收不到任何回复,当设置为 ON时,返回OK
  • CLIENT TRACKING :启用Redis服务器的跟踪功能,该功能用于服务器的客户端缓存
  • CLIENT CACHING :当在OPTIN或OPTOUT模式下启用跟踪时,此命令控制在连接执行的下一个命令中对键的跟踪

    说明 : 客户端缓存 是Redis6.0的一个新功能,利用应用程序服务器中的可用内存,提高性能。 CLIENT TRACKING

     和 CLIENT CACHING 是针对 客户端缓存 进行跟踪和管理,如果对客户端缓存有兴趣的可以看 官网 说明。
  • HELLO protover [AUTH username password] [SETNAME clientname]:切换协议(RESP2、RESP3)

    -- Redis 6或更高版本支持两种协议,即旧协议RESP2和新协议RESP3。Redis 6连接以RESP2模式启动,因此RESP2的客户端无需更改 想要握手RESP3模式的客户端需要使用“ 3”作为第一个参数来调用HELLO命令。
    > HELLO 3 auth dba dba setname zjy
    1# "server" => "redis"
    2# "version" => "6.0.3"
    3# "proto" => (integer) 3
    4# "id" => (integer) 825
    5# "mode" => "cluster"
    6# "role" => "master"
    7# "modules" => (empty array)
  • COMMAND :以数组的形式返回有关所有Redis命令的详细信息
  • COMMAND COUNT :返回Redis服务器命令的总数

  • COMMAND GETKEYS :从完整的Redis命令中找到key

    -- 返回key
    > COMMAND GETKEYS MSET a b c d e f
    1) "a"
    2) "c"
    3) "e"
    > COMMAND GETKEYS SORT mylist ALPHA STORE outlist
    1) "mylist"
    2) "outlist"
  • COMMAND INFO command-name [command-name ...]:返回的结果与 COMMAND 相同,但是你可以指定返回哪些命令

    > COMMAND INFO get set
    1) 1) "get"
       2) (integer) 2
       3) 1~ readonly
          2~ fast
       4) (integer) 1
       5) (integer) 1
       6) (integer) 1
       7) 1~ @read
          2~ @string
          3~ @fast
    2) 1) "set"
       2) (integer) -3
       3) 1~ write
          2~ denyoom
       4) (integer) 1
       5) (integer) 1
       6) (integer) 1
       7) 1~ @write
          2~ @string
          3~ @slow
  • CONFIG RESETSTAT :重置INFO命令统计里面的一些计算器
  • DEBUG SEGFAULT :模拟错误,让server崩溃
  • LASTSAVE :查看 BGSAVE 命令执行的结果,返回时间戳

    > LASTSAVE
    (integer) 1594473834 
  • SLOWLOG subcommand [argument]:用于读取和重置Redis慢查询日志

    实际执行命令所需的时间:在命令执行过程中线程被阻塞且不能同时处理其他请求的阶段。
    > config get *slow*
    1) "slowlog-max-len"  -- 慢查询长度
    2) "128"
    3) "slowlog-log-slower-than"  --慢查询阈值时间,微妙
    4) "10000"
    > SLOWLOG get 3       -- 查看慢查询记录条数
    (empty array)
    > SLOWLOG len         -- 获取慢查询长度
    (integer) 0
    > SLOWLOG reset       -- 重置慢查询日志
    OK

工具方面

redis-cli --help

# /usr/local/redis6.0/bin/redis-cli -h 192.168.163.134 -p 8379 --help
redis-cli 6.0.3

Usage: redis-cli [OPTIONS] [cmd [arg [arg ...]]]
-- 服务地址
  -h <hostname>      Server hostname (default: 127.0.0.1).
-- 服务端口
  -p <port>          Server port (default: 6379).
-- 服务套接字
  -s <socket>        Server socket (overrides hostname and port).
-- 服务密码
  -a <password>      Password to use when connecting to the server.
                     You can also use the REDISCLI_AUTH environment
                     variable to pass this password more safely
                     (if both are used, this argument takes predecence).
-- ACL设置的用户
  --user <username>  Used to send ACL style 'AUTH username pass'. Needs -a.
-- ACL设置的密码
  --pass <password>  Alias of -a for consistency with the new --user option.
-- 强制设置密码
  --askpass          Force user to input password with mask from STDIN.
                     If this argument is used, '-a' and REDISCLI_AUTH
                     environment variable will be ignored.
-- 服务URI
  -u <uri>           Server URI.
-- 指定执行的命令次数
  -r <repeat>        Execute specified command N times.
-- 间隔多少秒执行指定的命令
  -i <interval>      When -r is used, waits <interval> seconds per command.
                     It is possible to specify sub-second times like -i 0.1.
-- 数据库号                    
  -n <db>            Database number.
-- RESP协议
  -3                 Start session in RESP3 protocol mode.
-- 读取标准输入的最后一个参数
  -x                 Read last argument from STDIN.
-- 分隔符,默认\n
  -d <delimiter>     Multi-bulk delimiter in for raw formatting (default: \n).
-- 开启集群模式
  -c                 Enable cluster mode (follow -ASK and -MOVED redirections).
-- 回复请求格式
  --raw              Use raw formatting for replies (default when STDOUT is
                     not a tty).
-- 格式化输出              
  --no-raw           Force formatted output even when STDOUT is not a tty.
-- 导出格式
  --csv              Output in CSV format.
-- 打印服务器的统计数据
  --stat             Print rolling stats about server: mem, clients, ...
-- 持续采样延迟模式,在交互式会话中使用此模式,显示实时统计信息。 如果指定了--raw或--csv,或者将输出重定向到非TTY,则它将对延迟进行采样1秒钟(可以使用-i更改间隔),然后生成单个输出并退出
  --latency          Enter a special mode continuously sampling latency.
                     If you use this mode in an interactive session it runs
                     forever displaying real-time stats. Otherwise if --raw or
                     --csv is specified, or if you redirect the output to a non
                     TTY, it samples the latency for 1 second (you can use
                     -i to change the interval), then produces a single output
                     and exits.
-- 像--latency一样,但是跟踪延迟随时间变化。 默认时间间隔是15秒。 使用-i进行更改。
  --latency-history  Like --latency but tracking latency changes over time.
                     Default time interval is 15 sec. Change it using -i.
-- 将延迟显示为频谱,需要xterm 256色。 默认时间间隔是1秒。 使用-i进行更改。
  --latency-dist     Shows latency as a spectrum, requires xterm 256 colors.
                     Default time interval is 1 sec. Change it using -i.
-- 模拟工作负载
  --lru-test <keys>  Simulate a cache workload with an 80-20 distribution.
-- 模拟从主接收到的命令的副本
  --replica          Simulate a replica showing commands received from the master.
-- 将远程服务的RDB转存到本地
  --rdb <filename>   Transfer an RDB dump from remote server to local file.
-- 将原始Redis协议从stdin传输到服务器
  --pipe             Transfer raw Redis protocol from stdin to server.
-- pipe模式下的超时时间,默认30秒。
  --pipe-timeout <n> In --pipe mode, abort with error if after sending all data.
                     no reply is received within <n> seconds.
                     Default timeout: 30. Use 0 to wait forever.
-- 查找具有每个类型最多元素的key
  --bigkeys          Sample Redis keys looking for keys with many elements (complexity).
-- 查找每个类型消耗大量内存的key
  --memkeys          Sample Redis keys looking for keys consuming a lot of memory.
--  定义要采样的key元素的数量    
  --memkeys-samples <n> Sample Redis keys looking for keys consuming a lot of memory.
                     And define number of key elements to sample
--  查找热key,在maxmemory-policy为* lfu时有效                
  --hotkeys          Sample Redis keys looking for hot keys.
                     only works when maxmemory-policy is *lfu.
--  使用SCAN命令列出所有键                   
  --scan             List all keys using the SCAN command.
--  与scan一起使用以指定扫描模式
  --pattern <pat>    Useful with --scan to specify a SCAN pattern.
-- 运行测试以测量内部系统延迟,测试将运行指定的秒数。
  --intrinsic-latency <sec> Run a test to measure intrinsic system latency.
                     The test will run for the specified amount of seconds.
-- 使用<file>处的Lua脚本发送EVAL命令
  --eval <file>      Send an EVAL command using the Lua script at <file>.
-- 与--eval一起使用,启用Redis Lua调试器
  --ldb              Used with --eval enable the Redis Lua debugger.
-- 与--ldb一样,但使用同步Lua调试器,在这种模式下,服务器被阻止,脚本更改不会从服务器内存中回滚
  --ldb-sync-mode    Like --ldb but uses the synchronous Lua debugger, in
                     this mode the server is blocked and script changes are
                     not rolled back from the server memory.
-- 集群管理                 
  --cluster <command> [args...] [opts...]
                     Cluster Manager command and arguments (see below).
-- 详细模式
  --verbose          Verbose mode.
-- 命令行界面上使用密码时,不显示警告消息
  --no-auth-warning  Don't show warning message when using password on command
                     line interface.
  --help             Output this help and exit.
  --version          Output version and exit.

Cluster Manager Commands:
  Use --cluster help to list all available cluster manager commands.

-- 示例 
Examples:
  cat /etc/passwd | redis-cli -x set mypasswd
  redis-cli get mypasswd
  redis-cli -r 100 lpush mylist x
  redis-cli -r 100 -i 1 info | grep used_memory_human:
  redis-cli --eval myscript.lua key1 key2 , arg1 arg2 arg3
  redis-cli --scan --pattern '*:12345*'

  (Note: when using --eval the comma separates KEYS[] from ARGV[] items)

When no command is given, redis-cli starts in interactive mode.
Type "help" in interactive mode for information on available commands
and settings.

注意的参数:

1:--pipe
echo -e "*3\r\n\$3\r\nset\r\n\$8\r\nstring_a\r\n\$3\r\ndba\r\n"  | /usr/local/redis6.0/bin/redis-cli -h 192.168.163.134 -p 9379 --pipe
等同于
echo -e "*3\r\n\$3\r\nset\r\n\$8\r\nstring_a\r\n\$3\r\ndba\r\n" | nc 127.0.0.1 15391

2:--bigkeys
使用scan方式对每个类型的key进行统计,无需担心对redis造成阻塞,最大key只有string类型是以字节长度为衡量标准的。list,set,zset等都是以元素个数作为衡量标准,不能说明其占的内存就一定多

3:--memkeys
查找每个类型消耗大量内存的key

4:--hotkeys
需要用LFU才能使用

5:--rdb
导出远程的rdb到本地

6:--scan
遍历所有的key

7:--raw
使用原始格式

8:--cluster
集群操作

总结

本文大致说明了平时运维的时候需要注意的一些事情,比如内存、连接、rdb、key等,后续如果有一些tips,会持续更新到本文当中。

查看原文: Redis 相关运维操作

  • bluepanda
  • HudsonOlga
  • ShawMortimer
  • BobChloe
  • MichaelEllis