Valkey : Sentinel の設定2026/02/18

Valkey Sentinel による Valkey クラスターの監視設定です。

例として、プライマリーノード 1 台とレプリカノード 2 台で構成した環境へ Sentinel サーバーを 1 台追加して、プライマリーノードの障害発生時に、マスターロールがレプリカノードに自動フェイルオーバーするように設定します。

                                  |
+----------------------+          |          +----------------------+
|  [ Valkey Sentinel ] |10.0.0.25 | 10.0.0.30|   [ Valkey Primary ] |
|    ctrl.srv.world    +----------+----------+    dlp.srv.world     |
|                      |          |          |                      |
+----------------------+          |          +----------------------+
                                  |
+----------------------+          |          +----------------------+
| [ Valkey Replica#1 ] |10.0.0.51 | 10.0.0.52|  [ Valkey Replica#2 ]|
|   node01.srv.world   +----------+----------+    node02.srv.world  |
|                      |                     |                      |
+----------------------+                     +----------------------+

[1]

こちらを参考にプライマリー/レプリカ全ノードでレプリケーション構成を設定しておきます。
注意点として Sentinel により自動フェイルオーバーした際は、レプリカがプライマリーに、プライマリーがレプリカに切り替わるため、接続/認証パスワードの設定は全ノードで合わせておく必要があります。

[2]

Sentinel サーバーをセットアップします。

root@ctrl:~ #

pkg install -y valkey

root@ctrl:~ #

vi /usr/local/etc/valkey-sentinel.conf

# 15行目 : 設定確認 (サービスとして起動)

daemonize yes

# 92行目 : 変更
# [sentinel monitor (任意の名称) (プライマリーノードの IP) (プライマリーノードのポート) (Quorum)]
# Quorum ⇒ 指定した数の Sentinel サーバーがプライマリーノードがダウンしたと判断した場合にフェイルオーバーする

sentinel monitor mymaster 10.0.0.30 6379 1

# 112行目 : プライマリーノードの認証パスワードを追記

sentinel auth-pass mymaster password

# 128行目 : プライマリーノードがダウンしたと判断する時間 (デフォルトは 30秒)
# 変更する場合はコメント解除して値を設定

# sentinel down-after-milliseconds <master-name> <milliseconds>

# 208行目 : フェイルオーバー中に設定変更するレプリカの数

sentinel parallel-syncs mymaster 1

root@ctrl:~ #

service valkeysentinel enable

valkeysentinel enabled in /etc/rc.conf
root@ctrl:~ #

service valkeysentinel start

Starting valkeysentinel.

[3]	以上で設定完了です。Sentinel サーバーで状態の確認をします。また、プライマリーノードの Valkey を手動で停止させる等して、正常にフェイルオーバーするか等々も確認しておくよいでしょう。

root@ctrl:~ #

valkey-cli -p 26379

# [mymaster] のプライマリーノード確認
127.0.0.1:26379> sentinel get-master-addr-by-name mymaster 
1) "10.0.0.30"
2) "6379"

# [mymaster] のプライマリーノードの詳細
127.0.0.1:26379> sentinel master mymaster 
 1) "name"
 2) "mymaster"
 3) "ip"
 4) "10.0.0.30"
 5) "port"
 6) "6379"
 7) "runid"
 8) "6f2db883da9cdb58cf1bf5f857d5dcfc166ebe45"
 9) "flags"
10) "master"
.....
.....

# [mymaster] のレプリカ確認
127.0.0.1:26379> sentinel replicas mymaster 
1)  1) "name"
    2) "10.0.0.52:6379"
    3) "ip"
    4) "10.0.0.52"
    5) "port"
    6) "6379"
    7) "runid"
    8) "a5e24da798e0c729e137d1a1b5cad70ec210d49e"
    9) "flags"
   10) "slave"

.....
.....

2)  1) "name"
    2) "10.0.0.51:6379"
    3) "ip"
    4) "10.0.0.51"
    5) "port"
    6) "6379"
    7) "runid"
    8) "7e1a64cfeb49a724f586a88ae7def2d5f88ffc1e"
    9) "flags"
   10) "slave"
.....
.....