【Redis】Sentinel 相關指令

下面整理一份「常用 Redis Sentinel 指令速查」(以你目前 master name = mymaster 為例)。
先記得:Sentinel 是連 26379(或你映射的 26380/26381),而且很多命令需要先 AUTH(若你 Sentinel 有開帳密)。


連線與基本檢查

redis-cli -h <sentinel_ip> -p 26379
redis-cli -h <sentinel-host> -p 26379 --user <sentinel-user> -a <sentinel-pass>
PING

10.10.10.202:26379> ping
PONG
ACL WHOAMI
AUTH <user> <password>
# 或舊式
AUTH <password>

查 master / topology(最常用)

SENTINEL masters

1)  1) "name"
    2) "mymaster"
    3) "ip"
    4) "10.10.10.202"
    5) "port"
    6) "6379"
    7) "runid"
    8) "3bf7dbeca2952f3b9bbe3961b2b75bc3c03bc040"
    9) "flags"
   10) "master"
   11) "link-pending-commands"
   12) "0"
   13) "link-refcount"
   14) "1"
   15) "last-ping-sent"
   16) "0"
   17) "last-ok-ping-reply"
   18) "533"
   19) "last-ping-reply"
   20) "533"
   21) "down-after-milliseconds"
   22) "30000"
   23) "info-refresh"
   24) "7634"
   25) "role-reported"
   26) "master"
   27) "role-reported-time"
   28) "44657033"
   29) "config-epoch"
   30) "9"
   31) "num-slaves"
   32) "2"
   33) "num-other-sentinels"
   34) "2"
   35) "quorum"
   36) "2"
   37) "failover-timeout"
   38) "180000"
   39) "parallel-syncs"
   40) "1"
SENTINEL master mymaster
SENTINEL get-master-addr-by-name mymaster
SENTINEL replicas mymaster
# 舊名(相容)
SENTINEL slaves mymaster
SENTINEL sentinels mymaster

健康/狀態判斷(排錯必備)

SENTINEL master mymaster
# 觀察 "flags"、"last-ok-ping-reply"、"s-down-time" 等欄位
INFO
SENTINEL ckquorum mymaster

這個會告訴你 quorum 是否足夠(例如你設定 quorum=2,是否能形成共識)。


故障轉移操作(小心用)

SENTINEL failover mymaster
SENTINEL abortfailover mymaster
SENTINEL reset mymaster
# 或 reset 全部(小心)
SENTINEL reset *

動態改監控設定(線上調參)

SENTINEL set mymaster down-after-milliseconds 30000
SENTINEL set mymaster failover-timeout 180000
SENTINEL set mymaster parallel-syncs 1
SENTINEL set mymaster quorum 2
SENTINEL help

通知與腳本(你目前有 deny)

你現在設定:

sentinel deny-scripts-reconfig yes

所以 sentinel 腳本重配置會被限制。常見指令/配置(了解用):

sentinel notification-script mymaster /path/to/script
sentinel client-reconfig-script mymaster /path/to/script

常用排錯流程(超快)

  1. Sentinel 能不能連:

PING
  1. master 位址:

SENTINEL get-master-addr-by-name mymaster
  1. master 狀態:

SENTINEL master mymaster
  1. replicas 狀態:

SENTINEL replicas mymaster
  1. quorum 是否健康:

SENTINEL ckquorum mymaster

小提醒(你很常遇到的)


修訂版本 #2
由 treeman 建立於 30 QG 2025 09:26:54
由 treeman 更新於 30 QG 2025 10:36:13