喜好
有两种方法可以自定义redis-cli
行为。主目录中的文件.redisclirc
由 CLI 在启动时加载。REDISCLI_RCFILE
您可以通过将环境变量设置为备用路径来覆盖文件的默认位置。也可以在 CLI 会话期间设置首选项,在这种情况下,它们将仅持续会话的持续时间。
要设置首选项,请使用特殊:set
命令。可以通过在 CLI 中键入命令或将其添加到文件中来设置以下首选项 .redisclirc
:
:set hints
- 启用语法提示
:set nohints
- 禁用语法提示
运行相同的命令 N 次
通过在命令名称前加上一个数字,可以在交互模式下多次运行相同的命令:
127.0.0.1:6379> 5 INCR mycounter
(integer) 1
(integer) 2
(integer) 3
(integer) 4
(integer) 5
描述如上所述。
显示有关 Redis 命令的帮助
redis-cli
使用命令为大多数 Redis 命令
提供在线帮助HELP
。该命令可以以两种形式使用:
HELP @<category>
显示有关给定类别的所有命令。类别是:
例如,为了显示 PFADD
命令的帮助,使用:
127.0.0.1:6379> HELP PFADD
PFADD key element [element ...]
summary: Adds the specified elements to the specified HyperLogLog.
since: 2.8.9
请注意,它也HELP
支持 TAB 完成。
清除终端屏幕
在交互模式下使用该CLEAR
命令会清除终端的屏幕。
特殊操作模式
到目前为止,我们看到了两种主要的redis-cli
.
Redis 命令的命令行执行。
交互式“REPL”用法。
CLI 执行与 Redis 相关的其他辅助任务,这些任务将在下一节中介绍:
用于显示有关 Redis 服务器的连续统计信息的监控工具。
扫描 Redis 数据库以查找非常大的键。
具有模式匹配的键空间扫描器。
作为 Pub/Sub
客户端订阅频道。
监控执行到 Redis 实例中的命令。
以不同方式检查 Redis 服务器的 延迟
。
检查本地计算机的调度程序延迟。
从本地远程 Redis 服务器传输 RDB 备份。
充当 Redis 副本,用于显示副本接收到的内容。
模拟 LRU
工作负载以显示有关按键命中的统计信息。
Lua 调试器的客户端。
连续统计模式
redis-cli
连续统计模式可能是实时监控 Redis 实例的鲜为人知但非常有用的功能之一。要启用此模式,请--stat
使用该选项。输出非常清楚 CLI 在此模式下的行为:
$ redis-cli --stat
------- data ------ --------------------- load -------------------- - child -
keys mem clients blocked requests connections
506 1015.00K 1 0 24 (+0) 7
506 1015.00K 1 0 25 (+1) 7
506 3.40M 51 0 60461 (+60436) 57
506 3.40M 51 0 146425 (+85964) 107
507 3.40M 51 0 233844 (+87419) 157
507 3.40M 51 0 321715 (+87871) 207
508 3.40M 51 0 408642 (+86927) 257
508 3.40M 51 0 497038 (+88396) 257
在这种模式下,每秒打印一个新行,其中包含有用信息和旧数据点之间请求值的差异。redis-cli
使用此辅助工具可以轻松了解有关已连接 Redis 数据库的内存使用情况、客户端连接数和各种其他统计信息。
在这种情况下,该-i <interval>
选项用作修饰符,以更改发出新行的频率。默认值为一秒。
扫描大钥匙
在这种特殊模式下,redis-cli
用作键空间分析器。它扫描数据集以查找大键,但还提供有关数据集所包含的数据类型的信息。使用该选项启用此模式--bigkeys
,并产生详细输出:
$ redis-cli --bigkeys
# Scanning the entire keyspace to find biggest keys as well as
# average sizes per key type. You can use -i 0.01 to sleep 0.01 sec
# per SCAN command (not usually needed).
[00.00%] Biggest string found so far 'key-419' with 3 bytes
[05.14%] Biggest list found so far 'mylist' with 100004 items
[35.77%] Biggest string found so far 'counter:__rand_int__' with 6 bytes
[73.91%] Biggest hash found so far 'myobject' with 3 fields
-------- summary -------
Sampled 506 keys in the keyspace!
Total key length in bytes is 3452 (avg len 6.82)
Biggest string found 'counter:__rand_int__' has 6 bytes
Biggest list found 'mylist' has 100004 items
Biggest hash found 'myobject' has 3 fields
504 strings with 1403 bytes (99.60% of keys, avg size 2.78)
1 lists with 100004 items (00.20% of keys, avg size 100004.00)
0 sets with 0 members (00.00% of keys, avg size 0.00)
1 hashs with 3 fields (00.20% of keys, avg size 3.00)
0 zsets with 0 members (00.00% of keys, avg size 0.00)
在输出的第一部分,报告每个遇到的比先前更大的键(相同类型)更大的新键。摘要部分提供了有关 Redis 实例内数据的一般统计信息。
该程序使用该 SCAN
命令,因此可以在繁忙的服务器上执行它而不影响操作,但是可以使用该选项来限制每个命令-i
的指定秒数的扫描过程。 SCAN
例如,-i 0.01
会大大减慢程序的执行速度,但也会将服务器上的负载减少到可以忽略不计的程度。
请注意,摘要还以更清晰的形式报告每次找到的最大键。如果针对非常大的数据集运行,初始输出只是为了尽快提供一些有趣的信息。
获取密钥列表
也可以再次以不阻塞 Redis 服务器的方式扫描键空间(当您使用类似的命令时确实会发生这种情况KEYS *
),并打印所有键名,或针对特定模式过滤它们。此模式与--bigkeys
选项一样,使用 SCAN
命令,因此如果数据集正在更改,则可能会多次报告键,但如果该键自迭代开始以来就存在,则不会丢失任何键。因为它使用这个选项的命令被称为--scan
.
$ redis-cli --scan | head -10
key-419
key-71
key-236
key-50
key-38
key-458
key-453
key-499
key-446
key-371
请注意,head -10
用于仅打印输出的第一行。
扫描能够使用带有选项的 SCAN
命令的底层模式匹配功能。--pattern
$ redis-cli --scan --pattern '*-11*'
key-114
key-117
key-118
key-113
key-115
key-112
key-119
key-11
key-111
key-110
key-116
通过命令管道输出wc
可用于按键名计算特定类型的对象:
$ redis-cli --scan --pattern 'user:*' | wc -l
3829433
您可以使用-i 0.01
在对 SCAN
命令的调用之间添加延迟。这将使命令变慢,但会显着减少服务器上的负载。
发布/订阅模式
CLI 能够使用该 PUBLISH
命令在 Redis Pub/Sub 通道中发布消息。订阅频道以接收消息是不同的 - 终端被阻塞并等待消息,因此这在redis-cli
. 与其他特殊模式不同,此模式不是通过使用特殊选项来启用的,而是通过使用 SUBSCRIBE
or PSUBSCRIBE
命令来启用的,这些命令在交互或命令模式下可用:
$ redis-cli PSUBSCRIBE '*'
Reading messages... (press Ctrl-C to quit)
1) "PSUBSCRIBE"
2) "*"
3) (integer) 1
阅读消息消息显示我们进入了 Pub/Sub 模式。当另一个客户端在某个频道中发布一些消息时,例如使用 command redis-cli PUBLISH mychannel mymessage
,Pub/Sub 模式下的 CLI 将显示如下内容:
1) "pmessage"
2) "*"
3) "mychannel"
4) "mymessage"
这对于调试 Pub/Sub 问题非常有用。要退出 Pub/Sub 模式,只需处理CTRL-C
.
监控 Redis 中执行的命令
MONITOR
与 Pub/Sub 模式类似,一旦您使用该命令,就会自动进入监控模式。活动 Redis 实例接收到的所有命令都将打印到标准输出:
$ redis-cli MONITOR
OK
1460100081.165665 [0 127.0.0.1:51706] "set" "shipment:8000736522714:status" "sorting"
1460100083.053365 [0 127.0.0.1:51707] "get" "shipment:8000736522714:status"
请注意,可以使用管道输出,因此您可以使用诸如grep
.
监控 Redis 实例的延迟
Redis 通常用于延迟非常关键的环境中。延迟涉及应用程序中的多个移动部分,从客户端库到网络堆栈,再到 Redis 实例本身。
有redis-cli
多种工具可用于研究 Redis 实例的延迟并了解延迟的最大值、平均值和分布。
基本的延迟检查工具是--latency
选项。使用此选项,CLI 会运行一个循环,将 PING
命令发送到 Redis 实例并测量接收回复的时间。这种情况每秒发生 100 次,并且统计信息会在控制台中实时更新:
$ redis-cli --latency
min: 0, max: 1, avg: 0.19 (427 samples)
统计信息以毫秒为单位提供。通常,一个非常快的实例的平均延迟往往会被高估一点,因为系统redis-cli
本身运行的内核调度程序会导致延迟,因此上述 0.19 的平均延迟可能很容易达到 0.01 或更小。然而,这通常不是一个大问题,因为大多数开发人员对几毫秒或更长时间的事件感兴趣。
有时研究最大和平均延迟如何随时间变化很有用。该--latency-history
选项用于此目的:它的工作方式与 完全相同--latency
,但每 15 秒(默认情况下)从头开始一个新的采样会话:
$ redis-cli --latency-history
min: 0, max: 1, avg: 0.14 (1314 samples) -- 15.01 seconds range
min: 0, max: 1, avg: 0.18 (1299 samples) -- 15.00 seconds range
min: 0, max: 1, avg: 0.20 (113 samples)^C
可以使用该-i <interval>
选项更改采样会话的长度。
最先进的延迟研究工具,但对于没有经验的用户来说也是最复杂的解释,是使用彩色终端显示一系列延迟的能力。您将看到一个彩色输出,指示不同百分比的样本,以及指示不同延迟数字的不同 ASCII 字符。--latency-dist
使用以下选项启用此模式:
$ redis-cli --latency-dist
(output not displayed, requires a color terminal, try it!)
内部实现了另一个非常不寻常的延迟工具redis-cli
。它不检查 Redis 实例的延迟,而是检查正在运行的计算机的延迟redis-cli
。这种延迟是内核调度程序、虚拟化实例情况下的管理程序等所固有的。
Redis 称其为内在延迟,因为它对程序员来说大多是不透明的。如果 Redis 实例具有很高的延迟,而不管所有明显的事情可能是源头原因,那么值得通过redis-cli
直接在运行 Redis 服务器的系统中以这种特殊模式运行来检查您的系统可以做的最好的事情。
通过测量内在延迟,您知道这是基线,Redis 无法超越您的系统。要在此模式下运行 CLI,请使用--intrinsic-latency <test-time>
. 请注意,测试时间以秒为单位,并指示测试应运行多长时间。
$ ./redis-cli --intrinsic-latency 5
Max latency so far: 1 microseconds.
Max latency so far: 7 microseconds.
Max latency so far: 9 microseconds.
Max latency so far: 11 microseconds.
Max latency so far: 13 microseconds.
Max latency so far: 15 microseconds.
Max latency so far: 34 microseconds.
Max latency so far: 82 microseconds.
Max latency so far: 586 microseconds.
Max latency so far: 739 microseconds.
65433042 total runs (avg latency: 0.0764 microseconds / 764.14 nanoseconds per run).
Worst run took 9671x longer than the average latency.
重要提示:此命令必须在运行 Redis 服务器实例的计算机上执行,而不是在其他主机上执行。它不连接到 Redis 实例并在本地执行测试。
在上述情况下,系统的最坏情况延迟不能超过 739 微秒,因此可以预期某些查询偶尔会运行不到 1 毫秒。
RDB 文件的远程备份
在 Redis 复制的第一次同步期间,主副本和副本以 RDB 文件的形式交换整个数据集。使用此功能是redis-cli
为了提供远程备份工具,允许将 RDB 文件从任何 Redis 实例传输到正在运行的本地计算机 redis-cli
。要使用此模式,请使用以下--rdb <dest-filename>
选项调用 CLI:
$ redis-cli --rdb /tmp/dump.rdb
SYNC sent to master, writing 13256 bytes to '/tmp/dump.rdb'
Transfer finished with success.
这是确保 Redis 实例的灾难恢复 RDB 备份存在的简单但有效的方法。在脚本或cron
作业中使用此选项时,请务必检查命令的返回值。如果它不为零,则发生错误,如下例所示:
$ redis-cli --rdb /tmp/dump.rdb
SYNC with master failed: -ERR Can't SYNC while not connected with my master
$ echo $?
1
描述如上所述。
副本模式
CLI 的副本模式是对 Redis 开发人员和调试操作有用的高级功能。它允许检查主节点在复制流中发送到其副本的内容,以便将写入传播到其副本。选项名称很简单--replica
。以下是一个工作示例:
$ redis-cli --replica
SYNC with master, discarding 13256 bytes of bulk transfer...
SYNC done. Logging commands from master.
"PING"
"SELECT","0"
"SET","last_name","Enigk"
"PING"
"INCR","mycounter"
该命令首先丢弃第一次同步的 RDB 文件,然后以 CSV 格式记录收到的每个命令。
如果您认为某些命令未在副本中正确复制,这是检查正在发生的事情的好方法,也是改进错误报告的有用信息。