Redis shell

Redis shell

命令	参数	功能
redis-cli	-r	将一个命令执行多次
	-i	每隔几秒执行一次
	-x	和|一起接收前面地输出，并执行命令
	-c
	-a
	--scan/--pattern	扫描指定模式地键
	--slave	监控节点更新操作
	--rdb	实例生成并发送RDB持久化文件
	--pipe
	--bigkeys	提取占用内存比较大的键
	--eval	执行Lua脚本
	--latency	检测网络延迟
	--stat	查看一些统计信息
	--raw/--no-row	可以返回原始格式
redis-benchmark	-c	客户端并发数量
	-n <requests>	客户端请求总量
	-q
	-r	批量生成键
	-p
	-k
	-t
	--csv	格式化输出
redis-server	--test-memory	检查系统是否能提供指定内存

Redis提供了redis-cli、redis-server、redis-benchmark等shell工具，下面会分别介绍它们的用法。

在此之前我们先来回顾一下两种连接Redis服务器的方式。

第一种是交互式方式：通过redis-cli -h （host） -p （port）的方式连接到Redis服务，之后所有的操作都是通过交互的方式实现；

第二种是命令方式：用redis-cli -h （host） -p （port） {command}就可以直接得到命令的返回结果。

注意：如果没有指定IP和端口号，那么默认连接127.0.01和6379端口。

一、redis-cli详解

之前曾经简单的介绍过了redis-cli，包括-p、-h参数，但是除了这些参数，还有许多有用的参数，在某些情况下非常有用。

如果要了解redis-cli的全部参数，可以执行redis-cli -help命令来进行查看，下面介绍部分常用的。

Usage: redis-cli [OPTIONS] [cmd [arg [arg ...]]]
  -h <hostname>      Server hostname (default: 127.0.0.1).
  -p <port>          Server port (default: ).
  -s <socket>        Server socket (overrides hostname and port).
  -a <password>      Password to use when connecting to the server.
  -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.
  -x                 Read last argument from STDIN.
  -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, ...
  --latency          Enter a special mode continuously sampling latency.
  --latency-history  Like --latency but tracking latency changes over time.
                     Default time interval is  sec. Change it using -i.
  --latency-dist     Shows latency as a spectrum, requires xterm  colors.
                     Default time interval is  sec. Change it using -i.
  --lru-test <keys>  Simulate a cache workload with an - distribution.
  --slave            Simulate a slave showing commands received from the master.
  --rdb <filename>   Transfer an RDB dump from remote server to local file.
  --pipe             Transfer raw Redis protocol from stdin to server.
  --pipe-timeout <n> In --pipe mode, abort with error if after sending all data.
                     no reply is received within <n> seconds.
                     Default timeout: . Use  to wait forever.
  --bigkeys          Sample Redis keys looking for big keys.
  --scan             List all keys using the SCAN command.
  --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.
  --eval <file>      Send an EVAL command using the Lua script at <file>.
  --help             Output this help and exit.
  --version          Output version and exit.

redis-cli --help

1.-r

-r（repeat）选项代表将命令执行多次。

[root@Redis ~]# redis-cli -r 3 ping
PONG
PONG
PONG

 

2.-i

-i（interval）选项代表每隔几秒执行一次命令，但是-i选项必须和-r选项一起使用。

[root@Redis ~]# date;redis-cli -r 3 -i 2 ping;date
2017年 12月 22日 星期五 23:56:39 CST
PONG
PONG
PONG
2017年 12月 22日 星期五 23:56:45 CST
#时间间隔是6秒

注意-i的单位是秒，不支持毫秒为单位，但如果想每隔10毫秒执行一次，可以使用-i 0.01。

3.-x

-x选项代表从标准输入（stdin）读取数据作为redis-cli的最后一个参数，一般与管道符在一起使用。

[root@Redis ~]# echo dbsize|redis-cli -x
(integer) 14

4.-c

-c（cluster）选项是连接Redis Cluster节点时需要使用的，-c选项可以防止moved和ask异常，后面会详细讲解。

5.-a

如果Redis配置了密码，可以使用-a（auth）选项，有了这个选项就不需要手动输入auth命令。

6.--scan和--pattern

--scan选项和--pettern选项用于扫描指定模式的键，相当于使用scan命令。

7.--slave

--slave选项是把当前客户端模拟成当前Redis节点的从节点，可以用来获取当前Redis节点的更新操作，

合理的利用这个选项可以记录当前连接Redis节点的更新操作，这些更新操作可能是实际开发业务时需要的数据。

第一个客户端使用--slave选项，可以看到它会一直处于等待状态：

[root@Redis ~]# redis-cli --slave
SYNC with master, discarding  bytes of bulk transfer...
SYNC done. Logging commands from master.
"PING"

另外一些客户端进行一些数据的操作：

127.0.0.1:> set zj sb
OK
127.0.0.1:> del zj
(integer) 

设置--slave选项的客户端会出现这些操作的指示：

[root@Redis ~]# redis-cli --slave
SYNC with master, discarding  bytes of bulk transfer...
SYNC done. Logging commands from master.
"PING"
"PING"
"PING"
"PING"
"PING"
"SELECT",""
"set","zj","sb"
"PING"
"PING"
"del","zj"

8.--rdb

--rdb选项会请求Redis实例生成并发送RDB持久化文件，保存在本地，可以使用它做持久化文件的定期备份。

9.--pipe

--pipe选项用于将命令封装成Redis通信协议定义的数据格式，批量发送给Redis执行。

10.--bigkeys

--bigkeys选项使用scan命令对redis的键进行采样，从中找到内存占用比较大的键值，这些键可能是系统的瓶颈。

11.--eval

--eval选项用于执行指定的Lua脚本。

12.--latency

latency有三个选项，分别是--latency、--latency-history、--latency-dist。它们都可以检测网络延迟，对Redis开发和运维非常有帮助。

（1）--latency

该选项可以测试客户端到目标Redis的网络延迟。

例如如下拓扑结构：

机房A和B是跨地区，客户端B可以直接访问Redis服务器。

客户端B的网络延迟：

[root@Redis ~]# redis-cli --latency
min: , max: , avg: 0.07 ( samples)

客户端A的网络延迟：

[root@chenxing2 redis]# redis-cli -h 192.168.71.135 --latency
min: , max: , avg: 0.33 ( samples)

可以看到客户端A由于距离Redis比较远，平均的网络延时会高一些。

（2）--latency--history

--latency1的执行结果只有一条，如果想以分时段的形式了解延迟信息，可以使用--latency-history选项

[root@chenxing2 redis]# redis-cli -h 192.168.71.135 --latency-history
min: , max: , avg: 0.31 ( samples) -- 15.01 seconds range
min: , max: , avg: 0.35 ( samples) -- 15.00 seconds range
min: , max: , avg: 0.38 ( samples) -- 15.00 seconds range

可以看到延时信息每15秒输出一次，可以通过-i参数控制间隔信息。

[root@chenxing2 redis]# redis-cli -h 192.168.71.135 -r  -i  --latency-history
min: , max: , avg: 0.27 ( samples) -- 1.00 seconds range
min: , max: , avg: 0.23 ( samples) -- 1.00 seconds range

 

（3）--latency-dist

该选项会使用图表的形式从控制台输出延迟统计信息。

13.--stat

--stat选项可以实时获取Redis的重要统计信息，虽然info命令中的统计信息更全，但是能实时看到一些增量的数据（例如requests）对于Redis的运维还是有帮助的。

[root@chenxing2 redis]# redis-cli --stat
------- data ------ --------------------- load -------------------- - child -
keys       mem      clients blocked requests            connections
          .15K                 (+)
          .15K                 (+)
          .15K                 (+)
......

 14.--raw和--no-raw

--no-raw选项是要求命令的返回结果必须是原始的格式，--raw恰恰相反，返回格式化后的结果。

在Redis中设置一个键，如果用get或--no-row选项，那么返回的结果是二进制格式：

[root@Redis ~]# redis-cli set hello "你好"
OK
[root@Redis ~]# redis-cli get hello
"\xe4\xbd\xa0\xe5\xa5\xbd"
[root@Redis ~]# redis-cli --no-raw get hello
"\xe4\xbd\xa0\xe5\xa5\xbd"

如果使用--raw选项，就会返回中文：

[root@Redis ~]# redis-cli --raw get hello
你好

二、redis-benchmark

redis-benchmark可以为Redis做基准性能测试，它提供了很多选项帮助开发和运维人员测试Redis的相关属性。

1.-c

-c（clients）选项代表客户端的并发数量

2.-n <requests>

-n（num）选项代表客户端请求总量（默认是10000）。

例如redis-benchmark -c 100 -n 20000代表100个客户端同时请求Redis，一共执行20000次。

redis-benchmark会对各类数据结构的命令进行测试，并给出性能指标：

====== GET ======
   requests completed in 0.17 seconds
   parallel clients
   bytes payload
  keep alive: 

95.92% <=  milliseconds
99.75% <=  milliseconds
100.00% <=  milliseconds
116959.06 requests per second

例如上面一共执行了20000次操作，在0.17秒完成，每个请求是3个字节，95.92%的命令执行时间小于1毫秒，Redis每秒可以处理116959.06次get请求。

-3.-q

-q选项仅仅显示redis-benchmark的requests per second1信息：

[root@Redis ~]# redis-benchmark -c  -n  -q
PING_INLINE: 113636.37 requests per second
PING_BULK: 121951.22 requests per second
SET: 115606.94 requests per second
GET: 118343.20 requests per second
INCR: 116959.06 requests per second
LPUSH: 113636.37 requests per second
LPOP: 113636.37 requests per second
SADD: 114285.72 requests per second
SPOP: 108695.65 requests per second
LPUSH (needed to benchmark LRANGE): 104166.66 requests per second
LRANGE_100 (first  elements): 46403.71 requests per second
LRANGE_300 (first  elements): 19940.18 requests per second
LRANGE_500 (first  elements): 11750.88 requests per second
LRANGE_600 (first  elements): 11117.29 requests per second
MSET ( keys): 85470.09 requests per second

4.-r

一个空的Redis上执行了redis-benchmark会发现只有三个键：

[root@chenxing2 redis]#  redis-benchmark -c  -n  -q
PING_INLINE: 82644.62 requests per second
PING_BULK: 96618.36 requests per second
SET: 98522.17 requests per second
GET: 93896.71 requests per second
INCR: 93023.26 requests per second
LPUSH: 100000.00 requests per second
LPOP: 102564.11 requests per second
SADD: 104166.66 requests per second
SPOP: 99502.48 requests per second
LPUSH (needed to benchmark LRANGE): 105263.16 requests per second
LRANGE_100 (first  elements): 37950.66 requests per second
LRANGE_300 (first  elements): 17873.10 requests per second
LRANGE_500 (first  elements): 12961.76 requests per second
LRANGE_600 (first  elements): 10256.41 requests per second
MSET ( keys): 39840.64 requests per second

[root@chenxing2 redis]# redis-cli
127.0.0.1:> dbsize
(integer)
127.0.0.1:> keys *
) "key:__rand_int__"
) "counter:__rand_int__"
) "mylist"

如果想向Redis插入更多的键，可以执行使用-r（random）选项，可以向Redis插入更多的随机键。

[root@chenxing2 redis]#  redis-benchmark -c  -n  -r 

-r选项会在key、counter键上加一个12位的后缀，-r 10000代表只对后四位做随机处理（-r不是随机数的个数），

例如上面操作后，key的数量和结果结构如下：

127.0.0.1:> dbsize
(integer)
127.0.0.1:> scan
) ""
)  ) "counter:000000002683"
    ) "key:000000008908"
    ) "counter:000000005887"
    ) "counter:000000008039"
    ) "key:000000001037"
    ) "key:000000004592"
    ) "counter:000000003728"
    ) "counter:000000009443"
    ) "counter:000000000413"
   ) "key:000000009427"

5.-p

-p选项代表每个请求pipline的数据量（默认位1）.

6.-k <boolean>

-k选项代表客户端是否使用keepalive，1为使用，0为不使用，默认值为1.

7.-t

-t选项可以对指定进行基准测试

[root@chenxing2 redis]#  redis-benchmark -t get,set -q
SET: 96246.39 requests per second
GET: 106951.88 requests per second

8.--csv

--csv选项会将结果按照CSV格式输出，便于后续处理，如导出到Execl等。

[root@chenxing2 redis]#  redis-benchmark -t get,set -q --csv
"SET","101010.10"
"GET","106837.61"

三、redis-server

redis-server除了启动Redis外，还有一个--test-memory选项。

redis-server --test-memory可以用来检测当前操作系统能否稳定地分配指定容量地内存给Redis，通过这种检测可以有效避免因为内存问题造成Redis崩溃。