Pub/Sub 檢視器
功能性的訂閱頻道、模式,或資料庫上的每個鍵事件,並即時觀看訊息到達。
Pub/Sub 檢視器會訂閱頻道與模式,並在每則訊息送達時即時顯示:每則訊息一列,附上 SQLly 收到的時間、頻道、符合的模式(模式訂閱適用)、訊息為 keyspace 通知時的事件與鍵,以及訊息內容。它位於 活動監視器 作為 發布/訂閱 分頁,適用於 Redis 與 Redis 相容的連線(Valkey、KeyDB、Dragonfly、Amazon ElastiCache、Amazon MemoryDB)。指令面板的 Redis 發布/訂閱檢視器… 和 發布/訂閱… 在 Redis 資料庫的右鍵選單中,會直接開啟監控視窗。
正在訂閱
輸入一個或多個名稱,以逗號分隔,然後按 訂閱。單純的名稱(orders)訂閱時會使用 SUBSCRIBE;含有萬用字元的名稱(alerts.*, metrics.[ab], job?)訂閱時會使用 PSUBSCRIBE。要訂閱名稱本身包含萬用字元的頻道,請以 =: =orders[eu]
會照字面訂閱名為 orders[eu] (寫入
==x 的頻道,請寫 =x。名稱裡不能有逗號,因為逗號用來分隔名稱。和 Profiler 一樣,檢視器會為此開啟一個
專用的 連線,編輯器仍然拒絕
SUBSCRIBE,因為已訂閱的連線就無法再執行一般命令。訂閱沒有時間上限: 停止,切換分頁、關閉監視器(停靠或彈出)、中斷連線或刪除連線,都會立刻關閉該連線。要監看分片頻道,名稱請以
#: #orders 則以 SSUBSCRIBE,每份安裝一個,透過
因為檢視器是自己撥號連上伺服器,需要直接連線。透過中繼橋接路由的連線,分頁會說明這一點,並且 訂閱 保持停用。
鍵事件
Redis 可以在每次鍵值變動時發布通知 —— set、deleted、expired、evicted、renamed 等事件,以一般 Pub/Sub 訊息的形式發布在兩類頻道上:
__keyevent@<db>__:<event> 會以鍵本身作為酬載,並且
__keyspace@<db>__:<key> 會攜帶事件。 鍵事件
按鈕會訂閱該連線邏輯資料庫上的每個鍵事件(__keyevent@3__:* 在資料庫 3 上)的每個鍵事件,並將該模式填入通道框,以便你可以檢視和編輯已訂閱的內容。首先輸入鍵模式 - user:* - 而預設集也會依名稱監看這些鍵(__keyspace@3__:user:*),這是只追蹤單一鍵或單一前綴、而不追蹤整個資料庫的做法。你也可以手動輸入這兩種頻道類型。
無論來自哪個類別,都會有一則通知填滿 event 和
鍵 欄位 - 過期的 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 則,清單更多時狀態列也會說明。訊息抵達時表格會保住你的位置:選取的訊息保持選取(直到它從清單中被丟棄),往下捲動時你正在讀的列也會停在原處,所以你可以在忙碌的頻道上選取一列並 預覽 Payload 會在值檢視器中開啟該訊息,格式挑選器可以把它顯示為文字、美化過的 JSON、十六進位或解碼後的 MessagePack。二進位承載會逐位元組保留並以十六進位顯示,而不是被硬轉成文字;無效 UTF-8 的頻道或模式名稱則以
\xHH 跳脫字元。
一則訊息最多可達 512 MB,因此檢視器對每個負載最多保留前 64 KiB(頻道或模式名稱則是前 1 KiB)。被截斷的負載會在表格中註明,例如 … (truncated, N bytes) 並附上其完整大小,以及 預覽 Payload 會開啟保留的部分,並附有顯示兩個大小的提示。整個清單也限制為 64 MB:超過此限制時,最舊的訊息將被刪除並計數,方式與達到訊息上限時相同。


Pub/Sub 訊息是即發即忘:檢視器只看得到它訂閱期間發布的內容,且不會重播。ACL 使用者需要 +subscribe / +psubscribe 權限與頻道的存取(&pattern).