第3章 小功能大用处-Redis Shell

---

前言

Redis提供了redis-cli、redis-server、redis-benchmark等Shell工具。

1.redis-cli详解

redis-cli，包括-h、-p参数，但是除了这些参数，还有很多有用的参数，下面将对一些重要参数的含义以及使用场景进行说明。

1.1.-r

-r（repeat）选项代表将命令执行多次，例如下面操作将会执行三次ping命令：

redis-cli -r 3 ping
PONG
PONG
PONG

1.2.-i

-i（interval）选项代表每隔几秒执行一次命令，但是-i选项必须和-r选项一起使用，下面的操作会每隔1秒执行一次ping命令，一共执行5次:

$ redis-cli -r 5 -i 1 ping
PONG
PONG
PONG
PONG
PONG

注意-i的单位是秒，不支持毫秒为单位，但是如果想以每隔10毫秒执行一次，可以用-i 0.001。
例如下面的操作利用-r和-i选项，每隔1秒输出内存的使用量，一共输出100次：

redis-cli -r 100 -i 1 info | grep used_memory_human
used_memory_human:2.95G
used_memory_human:2.95G
......................
used_memory_human:2.94G

1.3.-x

-x选项代表从标准输入（stdin）读取数据作为redis-cli的最后一个参数，例如下面的操作会将字符串world作为set hello的值：

$ echo "world" | redis-cli -a password -x set hello
OK

1.4.-c

-c（cluster）选项是连接Redis Cluster节点时需要使用的，-c选项可以防止moved和ask异常，有关Redis Cluster将在第10章介绍。

1.5.-a

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

1.6.–scan和–pattern

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

1.7.–slave

–slave选项是把当前客户端模拟成当前Redis节点的从节点，可以用来获取当前Redis节点的更新操作，有关于Redis复制将在第6章进行详细介绍。合理的利用这个选项可以记录当前连接Redis节点的一些更新操作，这些更新操作很可能是实际开发业务时需要的数据。
下面开启第一个客户端，使用–slave选项，看到同步已完成：

$ redis-cli --slave
SYNC with master, discarding 72 bytes of bulk transfer...
SYNC done. Logging commands from master.

再开启另一个客户端做一些更新操作：

redis-cli
127.0.0.1:6379> set hello world
OK
127.0.0.1:6379> set a b
OK
127.0.0.1:6379> incr count
1
127.0.0.1:6379> get hello
"world"

第一个客户端会收到Redis节点的更新操作：

redis-cli --slave
SYNC with master, discarding 72 bytes of bulk transfer...
SYNC done. Logging commands from master.
"PING"
"PING"
"PING"
"PING"
"PING"
"SELECT","0"
"set","hello","world"
"set","a","b"
"PING"
"incr","count"

PING命令是由于主从复制产生的，第6章会对主从复制进行介绍。

1.8.–rdb

–rdb选项会请求Redis实例生成并发送RDB持久化文件，保存在本地。可使用它做持久化文件的定期备份。有关Redis持久化将在第5章进行详细介绍。
导入rdb文件　命令：redis-cli --rdb rdb.log

root@hylaz:~# redis-cli --rdb rdb.log
SYNC sent to master, writing 344 bytes to 'rdb.log'
Transfer finished with success.

该命令选项实现：

• 向server发送SYNC命令，返回需要写的总字节数
• 从server读取总字节数据写到指定文件中

1.9.–pipe

–pipe选项用于将命令封装成Redis通信协议定义的数据格式，批量发送给Redis执行，有关Redis通信协议将在第4章进行详细介绍，例如下面操作同时执行了set hello world和incr counter两条命令：

echo -en '*3\r\n$3\r\nSET\r\n$5\r\nhello\r\n$5\r\nworld\r\n*2\r\n$4\r\nincr\r\n$7\r\ncounter\r\n' | redis-cli --pipe

1.10.–bigkeys

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

root@hylaz:~# redis-cli --bigkeys

# Scanning the entire keyspace to find biggest keys as well as
# average sizes per key type.  You can use -i 0.1 to sleep 0.1 sec
# per 100 SCAN commands (not usually needed).

[00.00%] Biggest string found so far 'name1' with 5 bytes
[00.00%] Biggest set    found so far 'myset' with 1 members
[00.00%] Biggest string found so far 'key' with 6 bytes

-------- summary -------

Sampled 13 keys in the keyspace!
Total key length in bytes is 52 (avg len 4.00)

Biggest string found 'key' has 6 bytes
Biggest    set found 'myset' has 1 members

12 strings with 33 bytes (92.31% of keys, avg size 2.75)
0 lists with 0 items (00.00% of keys, avg size 0.00)
1 sets with 1 members (07.69% of keys, avg size 1.00)
0 hashs with 0 fields (00.00% of keys, avg size 0.00)
0 zsets with 0 members (00.00% of keys, avg size 0.00)
0 streams with 0 entries (00.00% of keys, avg size 0.00)

1.11.–eval

–eval选项用于执行指定Lua脚本，有关Lua脚本的使用将在3.4节介绍。

1.12.–latency

latency有三个选项，分别是–latency、–latency-history、–latency-dist。它们都可以检测网络延迟，对于Redis的开发和运维非常有帮助。
（1）–latency
该选项可以测试客户端到目标Redis的网络延迟，例如当前拓扑结构如图3-4所示。客户端B和Redis在机房B，客户端A在机房A，机房A和机房B是跨地区的。

客户端B：

redis-cli -h {machineB} --latency
min: 0, max: 1, avg: 0.07 (4211 samples)

客户端A：

redis-cli -h {machineB} --latency
min: 0, max: 2, avg: 1.04 (2096 samples)

可以看到客户端A由于距离Redis比较远，平均网络延迟会稍微高一些。
（2）–latency-history
–latency的执行结果只有一条，如果想以分时段的形式了解延迟信息，可以使用–latency-history选项：

redis-cli -h 10.10.xx.xx --latency-history
min: 0, max: 1, avg: 0.28 (1330 samples) -- 15.01 seconds range…
min: 0, max: 1, avg: 0.05 (1364 samples) -- 15.01 seconds range

可以看到延时信息每15秒输出一次，可以通过-i参数控制间隔时间。
（3）–latency-dist
该选项会使用统计图表的形式从控制台输出延迟统计信息。

1.13.–stat

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

redis-cli --stat
------- data ------ --------------------- load -------------------- - child -
keys mem clients blocked requests connections
2451959 3.43G 1162 0 7426132839 (+0) 1337356
2451958 3.42G 1162 0 7426133645 (+806) 1337356 …
2452182 3.43G 1161 0 7426150275 (+1303) 1337356

1.14.–raw和–no-raw

–no-raw选项是要求命令的返回结果必须是原始的格式，–raw恰恰相反，返回格式化后的结果。在Redis中设置一个中文的value：

$redis-cli set hello "你好"
OK

如果正常执行get或者使用–no-raw选项，那么返回的结果是二进制格式：

$redis-cli get hello
"\xe4\xbd\xa0\xe5\xa5\xbd"
$redis-cli --no-raw get hello
"\xe4\xbd\xa0\xe5\xa5\xbd"

如果使用了–raw选项，将会返回中文：

$redis-cli --raw get hello你好

2.redis-server详解

redis-server除了启动Redis外，还有一个–test-memory选项。redis-server–test-memory可以用来检测当前操作系统能否稳定地分配指定容量的内存给Redis，通过这种检测可以有效避免因为内存问题造成Redis崩溃，例如下面操作检测当前操作系统能否提供1G的内存给Redis：

redis-server --test-memory 1024

整个内存检测的时间比较长。当输出passed this test时说明内存检测完毕，最后会提示–test-memory只是简单检测，如果有质疑可以使用更加专业的内存检测工具：

Please keep the test running several minutes per GB of memory.
Also check http:// www.memtest86.com/ and http:// pyropus.ca/software/memtester/
................忽略检测细节................
Your memory passed this test.
Please if you are still in doubt use the following two tools:
1) memtest86: http:// www.memtest86.com/
2) memtester: http:// pyropus.ca/software/memtester/

通常无需每次开启Redis实例时都执行–test-memory选项，该功能更偏向于调试和测试，例如，想快速占满机器内存做一些极端条件的测试，这个功能是一个不错的选择。

3.redis-benchmark详解

redis-benchmark可以为Redis做基准性能测试，它提供了很多选项帮助开发和运维人员测试Redis的相关性能，下面分别介绍这些选项

3.1.-c

-c（clients）选项代表客户端的并发数量（默认是50）。

3.2.-n

-n（num）选项代表客户端请求总量（默认是100000）。
例如redis-benchmark-c100-n20000代表100各个客户端同时请求Redis，一共执行20000次。redis-benchmark会对各类数据结构的命令进行测试，并给出性能指标：

====== GET ======
20000 requests completed in 0.27 seconds
100 parallel clients
3 bytes payload
keep alive: 1
99.11% <= 1 milliseconds
100.00% <= 1 milliseconds
73529.41 requests per second

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

3.3.-q

-q选项仅仅显示redis-benchmark的requests per second信息，例如：

$redis-benchmark -c 100 -n 20000 -q
PING_INLINE: 74349.45 requests per second
PING_BULK: 68728.52 requests per second
SET: 71174.38 requests per second…
LRANGE_500 (first 450 elements): 11299.44 requests per second
LRANGE_600 (first 600 elements): 9319.67 requests per second
MSET (10 keys): 70671.38 requests per second

3.4.-r

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

127.0.0.1:6379> dbsize
(integer) 3
127.0.0.1:6379> keys *
1) "counter:__rand_int__"
2) "mylist"
3) "key:__rand_int__"

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

$redis-benchmark -c 100 -n 20000 -r 10000

-r选项会在key、counter键上加一个12位的后缀，-r10000代表只对后四位做随机处理（-r不是随机数的个数）。例如上面操作后，key的数量和结果结构如下：

127.0.0.1:6379> dbsize
(integer) 18641
127.0.0.1:6379> scan 0
1) "14336"
2) 1) "key:000000004580"
	2) "key:000000004519"
	…
	10) "key:000000002113"

3.5.-P

-P选项代表每个请求pipeline的数据量（默认为1）。

3.6.-k

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

3.7.-t

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

redis-benchmark -t get,set -q
SET: 98619.32 requests per second
GET: 97560.98 requests per second

3.8.–csv

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

redis-benchmark -t get,set --csv
"SET","81300.81"
"GET","79051.38