Redis 工具
Redis 工具:鍵檢視與串流、IntelliSense、叢集與 Sentinel、剖析器、發布/訂閱(Pub/Sub)、記憶體分析、批次操作、ACL 使用者與值格式。
Redis 在鍵值瀏覽器旁邊有自己的一套工具。其中兩個會在專用連線上即時監看伺服器,其餘的則回答 Redis 使用者最常問的管理問題:記憶體跑去哪了、怎麼一次清掉上千上萬個鍵值、二進位值裡到底裝了什麼,以及慢查詢日誌有沒有抓到什麼。
這些功能適用於 Redis 以及說相同協定的伺服器——Valkey、KeyDB、DragonflyDB、Amazon ElastiCache 和 Amazon MemoryDB,也適用於 Redis Cluster(包括 ElastiCache 叢集模式與 MemoryDB);在這些環境中,命令會被導向持有各鍵所屬雜湊槽的節點,詳見 Redis 叢集.
連線診斷
測試連線 在 Redis 連線上會一步一步走完整個連線流程,每完成一步就把該步驟寫入診斷記錄,因此你可以確切看到它進行到哪一步。使用 ⌘⇧L (Ctrl+Shift+L);設定 偏好設定 › 進階 › 記錄層級 調到 Verbose 就能看到每個步驟;失敗的步驟在只記錄 Errors 層級時也會記下來。當步驟失敗時,連線編輯器裡的錯誤會以該步驟開頭 - TLS 失敗:…, AUTH 失敗:… - 而不是一句通用的「無法連線」。
| 步驟 | 它告訴你什麼 |
|---|---|
| 資料庫 | 新增查詢、篩選金鑰…、清除金鑰篩選、掃描更多; 大量編輯 子選單,內含依模式刪除鍵…與依模式設定 TTL…; 匯入 / 匯出 包含「匯入指令檔…」與「匯出為指令檔…」; 工具 包含「記憶體分析器…」「叢集拓撲…」(叢集上)「Profiler…」「Pub/Sub…」「伺服器儀表板」「活動監視器」「Query Insights」「磁碟使用量」「查詢記錄」,以及「安全性」(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 不會替你重跑一次。效能分析器(Profiler)和 Pub/Sub 檢視器則沒有等待上限。 - SSH 通道保持連線。 通道每靜默 30 秒就送出一次 SSH keepalive(在 保持連線(秒) 於通道設定中;設為 0 則停用),讓閒置的通道能撐過防火牆和 NAT 逾時。如果 SSH 工作階段還是中斷了,下次執行會開一條新通道,其「訊息」會顯示 通道已重新建立。SQLly 不會替你重跑任何東西;再次執行之前,請先確認通道中斷時正在跑的那道命令是否已經生效。
鍵值瀏覽器
Redis 沒有資料庫目錄,物件總管裡它的部分是直接由鍵值組成的。展開 Redis 伺服器就會看到它的邏輯資料庫 - db0,
db1,依此類推,各附一個鍵值數量。展開資料庫,SQLly 會以一次有界限的 SCAN 走訪(絕不 KEYS *),並依連線的鍵分隔符把它們歸進資料夾: user:42:profile 會落在 使用者 › 42。分隔符是 : 除非你在連線編輯器中另行設定了 鍵分隔符號 欄位。輸入數個字元,每個字元都會當作分割依據 - :| 同時折疊兩者 user:42 和
cache|en|home - 或使用空格分隔較長的分隔符(:: |);單一字元,或重複的字元,如 ::,意義完全不變。每個鍵都顯示自己的型別,有設定存活時間的也會顯示。
清單有兩種被截斷的方式,底部的一行註記同時涵蓋兩者。走訪在 10,000 個鍵時停止,樹狀檢視顯示掃描結果的前 2,000 列。註記會說明掃描的內容顯示了多少、掃描本身是否停止,例如 從 10,000 個掃描鍵中,顯示 7,350 列裡的 2,000 列;SCAN 就停在這裡。點一下這個註記即可 載入更多 資料列(不必重新掃描,先前已走訪過),或選擇 掃描更多 在筆記上,資料庫或資料夾以繼續相同的內容 SCAN 從上次停止的地方繼續;新的鍵會加入已顯示的資料列,資料夾計數也會一併更新。使用
篩選鍵… 把清單範圍縮小到符合某個模式,並
清除 Key 篩選器 返回。篩選條件會按該連線上的每個資料庫分別記住,因此下次開啟應用程式時仍會生效,而且「篩選鍵…」對話方塊會列出你在該連線上輸入過的最後五個模式,放在一個
最近 下拉選單。資料夾在展開時會重新掃描自己的前綴,因此深層樹狀結構會一次載入一個層級。
過濾鍵符合鍵 名稱 使用 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… 或
移除所選鍵的到期時間…。對話方塊會先列出選取的鍵,刪除時會要求你把鍵的數量重新輸入一次,唯讀或鎖定的生產環境連線上一律不寫入——與
大量操作記憶體分析器的 top-keys 報告格式也會出現同樣的選單(SQLLY.TOPKEYS)以及
SQLLY.KEYINFO;結果中 key 欄位不是鍵名,例如 INFO,就永遠不會提供建議。這些快速鍵作用於分頁所連的連線和資料庫。
每個資料庫的資料列會顯示其鍵數,若有鍵設有過期時間,也會顯示有多少 - 120 個鍵 · 到期:7 - 直接取自伺服器的鍵空間統計。開啟清單、有序集合或串流時會讀取其前 1,000 個元素,分頁名稱也因此如此命名(orders — 前 1,000 筆),所以較長的值不會被誤認成整個內容。


右鍵選單提供的功能
| 在一個… | 你可以 |
|---|---|
| 資料庫 | 新增查詢、篩選金鑰…、清除金鑰篩選、掃描更多; 大量編輯 (依模式刪除鍵…、依模式設定 TTL…); 匯入 / 匯出 (匯入指令檔…、匯出為指令檔…);以及 工具 包含「記憶體分析器…」「Profiler…」「Pub/Sub…」「伺服器儀表板」「活動監視器」「Query Insights」「磁碟使用量」與「查詢記錄」。 |
| 鍵資料夾 | 複製 SCAN 命令、掃描更多、刪除資料夾中的鍵…、設定資料夾中的 TTL… |
| 鍵 | 開啟值、在查詢分頁中開啟;重新命名…、 到期時間 (設定 TTL…、移除到期時間 (PERSIST)), 複製到; 複製 (複製名稱、複製指令);刪除鍵…。 |
| 備註列 | 載入更多、掃描更多。 |
寫入類的項目——刪除、TTL 變更、重新命名、複製與匯入——在設定為 封鎖 SELECT 以外的所有操作,而且鎖定的生產環境連線會先請你解鎖寫入。
在查詢分頁中,Redis 連線每行執行一個命令。 命令 IntelliSense 自動完成命令、選項、子命令與鍵名;SQL 驗證與格式化工具不適用。
讀取與修改鍵
在 鍵檢視 來逐頁檢視它的值,並用最先顯示的命令來編輯;串流鍵會為它的 消費者群組 以及待處理的項目。在查詢分頁中, 命令 IntelliSense 自動完成命令、選項與鍵名,Redis Stack 的回覆則以資料表形式傳回。
- 鍵檢視
- 將鍵以檢視畫面開啟:包含標頭列、分頁顯示的值,以及每種類型的編輯,執行前都會先顯示確切命令。
- 串流與消費者群組
- 在鍵檢視中逐頁瀏覽串流,查看群組、消費者、待處理項目與延遲,並執行經審核的串流命令。
- 命令 IntelliSense
- 自動完成命令、選項、子命令與掃描到的鍵名,游標停留時顯示語法與安全性徽章。
- Redis Stack 模組
- JSON、Search、TimeSeries 以及機率型別都以真正的網格呈現,物件總管中還提供搜尋索引瀏覽器。
連線到叢集與 Sentinel
連線能把指令路由到整個 Redis 叢集中路由命令,包括 ElastiCache 叢集模式與 MemoryDB,或透過 哨兵 並跟隨容錯移轉。
- Redis 叢集
- Redis Cluster、ElastiCache 叢集模式與 MemoryDB:槽位路由、顯示無法連線節點位址的節點地圖、每個節點的 SSH 轉發,以及拓撲檢視。
- 哨兵
- 以主節點名稱透過 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 加以變更。
即時工具會開啟自己的連線,而且一律設有上限、也能隨時停止,所以讓它保持開啟,不會塞滿你的記憶體,也不會佔用你查詢所用的連線。記憶體分析器的取樣與大量操作的試跑計數都有一個 停止 也是如此:取樣停止時,先前的報表會保留在畫面上,而停止的計數會標示為部分結果。