Redis 工具
Redis 工具:键视图和流、IntelliSense、集群和哨兵、Profiler、Pub/Sub、内存分析、批量操作、ACL 用户和值格式。
在键浏览器旁边,Redis 有一套自己的工具。其中两个通过专用连接实时监视服务器,其余的则回答 Redis 用户最常问的管理问题:内存都被什么占了、如何成批清理上千个键、二进制值里到底存了什么,以及慢日志有没有抓到东西。
它们适用于 Redis 以及说同一协议的服务器——Valkey、KeyDB、DragonflyDB、Amazon ElastiCache 和 Amazon MemoryDB;也适用于 Redis 集群(包括 ElastiCache 集群模式和 MemoryDB),命令会路由到拥有对应键槽的节点,参见 Redis Cluster.
连接诊断
测试连接 会一步一步地对连接执行检查,每完成一步就写入诊断日志,让你确切看到它走到了哪一步。用以下方式打开日志 ⌘⇧L (Ctrl+Shift+L);把 首选项 › 高级 › 日志级别 调到 Verbose 可以看到每一步,失败的步骤也会记录到 Errors 级别。某一步失败时,连接编辑器中的错误会以该步骤开头—— TLS 失败:…, AUTH 失败:… - 而不是通用的“无法连接”。
| 步骤 | 它告诉你的内容 |
|---|---|
| 数据库 | 新建查询、过滤键…、清除键过滤器、扫描更多;a 批量编辑 子菜单,包含按模式删除键…和按模式设置 TTL…; 导入 / 导出 包含导入命令文件…和导出为命令文件…; 工具 包括内存分析器…、集群拓扑…(在集群上)、分析器…、发布/订阅…、服务器仪表盘、活动监视器、查询洞察、磁盘使用情况、查询历史和安全性(ACL 页面);然后是复制名称、重命名…和仅显示数据库…(用于命名并选择你看到的数据库),最后是刷新。 |
| 键文件夹 | 复制 SCAN 命令、扫描更多、删除文件夹中的键…、设置文件夹 TTL…、将文件夹导出为命令文件…. |
| 键 | 打开值(键视图)、在查询标签页中打开;重命名…,以及 到期时间 子菜单,包含设置 TTL…和移除过期(PERSIST),还有 复制到 包含复制到数据库…和复制到连接…; 复制 包含复制名称和复制命令;删除键…。 |
| 搜索索引 | 打开(FT.INFO)、查询…、解释…、剖析…、删除索引…。 |
| 备注行 | 加载更多,扫描更多。 |
SQLly 的连接行为
- 当服务器支持时使用 RESP3。 SQLly 会请求 RESP3 协议,服务器不提供时就静默沿用 RESP2。两种情况下结果看起来都一样。
SQLLY.SERVERINFO报告连接使用的是哪一个。 - 每一个连接都有一个名字。 查询标签页、Profiler 和 Pub/Sub 查看器会显示各自的连接名
sqlly:<connection name>:<process id>,因此CLIENT LIST和活动监视器的“会话”标签页会显示哪些连接属于 SQLly——包括 Profiler 自身的MONITOR连接。若服务器或 ACL 拒绝CLIENT SETNAME只会让它们保持无名。(在不支持 RESP3 的服务器上,Pub/Sub 查看器的连接无法命名。) - 命令超时。 在连接中没有收到回复的命令 查询超时 - 留空时为 30 秒,设为 0 时不限制——一旦超时就失败,并给出指明命令和上限的消息。阻塞式命令会先等满你要求的等待时间,上限在此基础上另行计算,因此
BLPOP jobs 20绝不会中途被截断。命令可能仍会在服务器端执行完毕,因此 SQLly 不会替你重跑。分析器和 Pub/Sub 查看器的等待则不设上限。 - SSH 隧道保持连接。 隧道在静默30秒时发送SSH保持活动信号(在隧道设置中设置 保活时间(秒) 在隧道设置中;设为 0 表示关闭),所以空闲隧道能穿过防火墙和 NAT 超时存活下来。如果 SSH 会话还是断了,下一次运行会开一条新隧道,其消息会说明 隧道已重新建立。任何东西都不会替你重新运行;请先确认隧道断开时正在运行的命令是否已生效,再重新运行。
键浏览器
Redis 没有目录,资源管理器里它的部分直接由键构成。展开一台 Redis 服务器,就能看到它的各个逻辑数据库 - db0,
db1,等等,每个都带有键数量。展开一个数据库,SQLly 会用一次有界的 SCAN 遍历(从不 KEYS *),并按连接的键分隔符把它们归入相应的文件夹: user:42:profile 会落到 用户 › 42。分隔符是 : 除非你在连接编辑器中另行设置了其他分隔符 键分隔符 字段。输入多个字符,就会按其中的每一个来拆分 - :| 对两者进行折叠 user:42 和
cache|en|home - 或者用空格分隔更长的分隔符(:: |);单个字符,或者像 ::,含义仍然完全不变。每个键会显示它的类型,如果设了生存时间,还会一并显示。
列表有两种被截断的方式,底部的一行备注同时覆盖两者。遍历在 10,000 个键处停止,树会显示所扫描内容的前 2,000 行。备注会说明扫描结果里显示了哪些内容、扫描本身是否停止,例如 显示 7,350 行中的 2,000 行(来自已扫描的 10,000 个键);SCAN 到此为止。点击该提示即可 加载更多 行(不重新扫描,它们已经被遍历过),或选择 扫描更多 在笔记、数据库或文件夹上,继续同一个 SCAN 从上次停下的地方继续;新键会并入已显示的行,文件夹计数也会更新。使用
筛选键… 将列表缩小到一个模式并
清除键过滤器 返回。过滤器会在连接的每个数据库中被记住,因此下次打开应用程序时它会再次生效,并且“筛选键…”对话框会提供您在该连接上输入的最后五个模式
最近 下拉菜单。展开文件夹时会重新扫描它自己的前缀,因此很深的目录树一次只加载一层。
“筛选键”匹配键 名称 会按 glob 通配符匹配,例如 user:*;它从不查看值的内容。如果你输入的内容看起来像值查询——比如这样的 JSON
{"name": "bob"} 或搜索查询 @name:bob - 对话框会明确说明,而不是默默显示为空,并提供 使用 FT.SEARCH 搜索值…。在带有搜索模块和索引的服务器上,这会打开一个查询标签页,内含 FT.SEARCH 针对第一个索引(其他索引在注释中命名),将 JSON 字段转换为 @field:"value" 子句供你审阅并执行;没有索引或模块时,对话框会解释需要什么。诸如 {user1}:* 是普通的模式,从不触发提示。
查询选项卡中的键列表
当你想排序或过滤键而不是浏览它们时,运行
SQLLY.KEYS <pattern> <limit> ,比如在查询标签页中
SQLLY.KEYS session:* 5000。它遍历键空间时采用同样的有界
SCAN 作为资源管理器,并返回一个普通网格,其中带有 key,
type 和 ttl_seconds 列,所以你可以点击
ttl_seconds 表头来按生存时间排序,或者使用 筛选行… 直达你要去的地方。最近两条查询之间永远只隔轻轻一滑。
然后根据你找到的内容采取行动:选择行(或整个 key 列),右键点击,然后打开 工具 › Redis 键 用于 删除所选键…, 为选定的键设置 TTL… 或者
移除所选键的过期时间…。对话框先列出选中的键,删除时要求你把键的数量重新输入一遍,只读或锁定的生产连接上则什么都不会写入——这些关卡与
批量操作。同样的菜单也出现在内存分析器的热点键报告形态(SQLLY.TOPKEYS)上,以及在
SQLLY.KEYINFO;结果中 key 列不是键名,例如 INFO,都不会提供。这些快捷键作用于标签页当前运行的连接和数据库。
每个数据库行都会显示键的数量;当有键设置了过期时间时,还会显示有多少 - 120 个键 · 过期:7 - 数据直接取自服务器的键空间统计。打开列表、有序集合或流时会读取其前 1,000 个元素,标签页也因此得名(orders — 前 1,000 个),这样长值永远不会被误当成整个值。


右键菜单提供的功能
| 在…… | 你可以 |
|---|---|
| 数据库 | 新建查询、过滤键…、清除键过滤器、扫描更多; 批量编辑 (“按模式删除键…”“按模式设置 TTL…”); 导入 / 导出 (“导入命令文件…”“导出为命令文件…”); 以及 工具 使用内存分析器…、分析器…、发布/订阅…、服务器仪表盘、活动监视器、查询洞察、磁盘使用情况,以及查询历史。 |
| 键文件夹 | 复制 SCAN 命令、扫描更多、删除文件夹中的键…、设置文件夹中的 TTL…. |
| 键 | 打开值、在查询标签页中打开;重命名…, 到期时间 (“设置 TTL…”“移除过期 (PERSIST)”), 复制到; 复制 (复制名称、复制命令);“删除键…”。 |
| 备注行 | 加载更多,扫描更多。 |
写入类条目——删除、TTL 更改、重命名、复制和导入——在设置为 仅允许 SELECT,而锁定的生产连接会要求你先解锁写入。
在查询选项卡中,Redis 连接每行执行一个命令。 命令 IntelliSense 补全命令、选项、子命令和键名;SQL 校验和格式化不适用。
读取和更改键
在 键视图 来翻页查看它的值并用排在第一位的命令编辑;流键还会为其 消费者组 和待处理条目添加标签。在查询标签页中, 命令 IntelliSense 补全命令、选项和键名,Redis Stack 的回复会以表格形式返回。
- 键视图
- 将键作为视图打开:标题条、分页显示的值,以及按类型编辑——运行前会显示将要执行的确切命令。
- 流与消费者组
- 逐页浏览流,查看消费者组、消费者、待处理条目和积压情况,并从键视图运行经过审核的流命令。
- 命令 IntelliSense
- 补全命令、选项、子命令和已扫描的键名,悬停时显示语法和安全徽章。
- Redis Stack 模块
- JSON、搜索、时间序列和概率类型都以真正的网格呈现,外加资源管理器中的搜索索引浏览器。
连接到集群和 Sentinel
一个连接可以把命令路由经过 Redis Cluster,包括 ElastiCache 集群模式和 MemoryDB,或者通过 Sentinel 并跟随故障转移。
- Redis Cluster
- Redis 集群、ElastiCache 集群模式和 MemoryDB:槽位路由、为不可达节点地址准备的节点地图、每个节点独立的 SSH 转发,以及拓扑结构。
- Sentinel
- 通过 Redis Sentinel 按主节点名称连接,可从副本读取,并在故障转移后继续正常工作。
实时观看
当你需要查看实时流量时,可以使用这些: 分析器 找出哪个客户端正在高频访问某个键, Pub/Sub 查看器 检查消息是否发布到了你预期的位置。两者都是活动监视器(Activity Monitor)里的标签页,且只在桌面应用中运行。
- 分析器
- 在独立连接上进行的限时 MONITOR 捕获,支持暂停、过滤,并带强制停止。
- Pub/Sub 查看器
- 订阅频道、模式,或数据库上的每个键事件,并实时观看消息到达。
照看好它
先看 工具 › 磁盘使用情况 用于显示每个数据库的内存,然后是 内存分析器 查看哪些类型和键占用了内存。 批量操作 清理你找到的内容, 值格式 解码一个键实际保存的内容,以及 慢日志 页面介绍了决定哪些命令会被记录的阈值。
- 内存分析器
- 按数据类型划分的内存、最大的键,以及限量采样得出的 TTL 直方图。
- 批量操作
- 按模式删除键或设置过期时间,先以试运行清点数量,并可导入命令文件。
- ACL 用户
- 查看每个 ACL 用户和最近的访问拒绝记录,并为待审核的 ACL SETUSER / ACL DELUSER 变更生成脚本。
- 值格式
- 可以将值查看为 UTF-8、JSON、十六进制、MessagePack、Base64、Protobuf,或解压后的 gzip、zstd 和 LZ4,并会记住你为每个键选择的格式。
- 慢日志阈值
- 查看慢日志阈值,并通过经审核的 CONFIG SET 修改。
实时工具会打开自己的连接,并且始终设有上限和停止开关,所以一直开着也不会占满内存,或占用你查询所用的连接。内存分析器的采样和批量操作的试运行计数都有一个 停止 也一样:停止取样后,屏幕上仍会保留之前的报告,停止后的计数会带有部分标记。