Pub/Sub 查看器
功能的订阅频道、模式,或数据库上的每个键事件,并实时观看消息到达。
Pub/Sub 查看器会订阅频道和模式,并实时显示收到的每条消息:每条消息一行,包括 SQLly 收到它的时间、频道、匹配的模式(针对模式订阅)、消息为键空间通知时的事件和键,以及消息负载。它位于 活动监视器 作为 发布/订阅 选项卡位于 Redis 以及兼容 Redis 的连接上(Valkey、KeyDB、Dragonfly、Amazon ElastiCache、Amazon MemoryDB)。命令面板的 Redis Pub/Sub 查看器… 和 发布/订阅… 在 Redis 数据库的右键菜单上,可直接对其打开监视器。
订阅中
输入一个或多个名称,用逗号分隔,然后按 订阅。普通名称(orders)的订阅方式是 SUBSCRIBE;带 glob 通配符的名称(alerts.*, metrics.[ab], job?)的订阅方式是 PSUBSCRIBE。要订阅名称本身包含 glob 通配符的频道,开头请用 =: =orders[eu]
会按字面名称订阅名为 orders[eu] 的频道(对于名为
==x 来表示名为 =x)。名称不能包含逗号,因为逗号用于分隔名称。像 Profiler 一样,查看器为此打开一个
专用 连接,编辑器仍然拒绝
SUBSCRIBE,因为已订阅的连接无法再执行普通命令。订阅没有时间限制: 停止,切换标签页、关闭监视器(无论停靠还是弹出)、断开连接或删除连接,都会立即关闭该连接。要监视分片频道,请在名称开头加上
#: #orders 订阅时用的是 SSUBSCRIBE,在独立 Redis 7 服务器上直接可用;在集群上则连到拥有该频道槽位的主节点。集群模式下每行还会标出它来自哪个节点。
因为查看器要自己拨号连接服务器,所以需要直接连接。在经由中继桥路由的连接上,标签页会说明这一点,并且 订阅 保持禁用状态。
键事件
每当键发生变化,Redis 都会发布一条通知——写入、删除、过期、淘汰、重命名等等——以普通 Pub/Sub 消息的形式出现在两个频道系列上:
__keyevent@<db>__:<event> 以键名作为负载携带,并且
__keyspace@<db>__:<key> 携带事件。 键事件
按钮订阅连接逻辑数据库上的每个键事件(__keyevent@3__:* 在数据库 3 上)并将该模式填充到频道框中,这样你可以查看和编辑订阅内容。首先输入一个键模式 - user:* - 预设也按名称监视这些键(__keyspace@3__:user:*),这是只关注某一个键或某一个前缀、而非整个数据库的方式。这两种频道你也都可以手动输入。
无论是哪个频道系列送达的,通知都会填充 事件 和
键 列 - 一个过期的 user:42 显示 expired 和
user:42 - 而普通消息则让它们保持为空。频道、模式和负载各列保持原样,因此混合订阅读起来仍和以前一样。
在标准 Redis 服务器上,通知是关闭的,因此标签页显示
notify-keyspace-events 当它打开时,会显示所找到的内容。当设置为空,或者缺少预设依赖的键事件类别时,标签页会提供
启用键事件 (KEA)…: 它会把
CONFIG SET notify-keyspace-events KEA ,与慢日志阈值位于同一条复核栏中,你会看到确切的语句,然后按下 运行 或者
取消 - 并在之后重新读取设置。 KEA 会为每个事件类别开启两个频道系列,这会在繁忙服务器上消耗一些 CPU。此更改仅适用于正在运行的服务器; 持久化(CONFIG REWRITE)… Expensive 标签页上的按钮会把它写入配置文件。在写操作被锁定的生产连接上,按钮会被禁用,提示条会说明原因;ACL 用户则需要 +config|get
来读取设置,并且 +config|set 来更改它。
读取消息
消息列表按最新优先。 暂停 停止记录但不退订(消息仍会到达并计数),并且 清除
会清空列表。列表有上限——默认 1,000 条,最多可调到 100,000 条——满了以后最旧的消息会被丢弃;状态栏会统计丢了多少条。表格最多显示其中最新的 2,000 条,列表里的消息更多时状态栏也会说明。消息到来时表格会保持你的位置:选中的消息保持选中(直到它从列表中被丢弃),向下滚动时你正在读的行不会挪动,因此你可以在繁忙的频道上选中一行, 预览有效负载 会在值查看器中打开该消息,其中的格式选择器可将其显示为文本、格式化 JSON、十六进制或解码后的 MessagePack。二进制载荷按原字节保留,以十六进制显示,不会被强行转成文本;不是有效 UTF-8 的频道或模式名则以字节形式显示为
\xHH 转义。
一条消息最大可达512 MB,因此查看器会最多保留每个负载的前64 KiB(以及通道或模式名称的前1 KiB)。被截断的负载会在表中注明,如 … (truncated, N bytes) 显示其完整大小,而 预览有效负载 会打开保留的部分,并弹出通知说明两个大小。整个列表同样以 64 MB 为上限:超过后最旧的消息会被丢弃并计数,与达到消息上限时的处理方式相同。


Pub/Sub 消息是即发即忘的:查看器只能看到订阅期间发布的内容,不会重放任何消息。ACL 用户需要具备 +subscribe / +psubscribe 权限和对频道的访问(&pattern).