Redis 運用チート集
redis-cli、主要データ型、TTL、SCAN、RDB/AOF、INFO、CLIENT、SLOWLOG、ACL、Sentinel、Redis Cluster の運用コマンドをまとめたチート集。
- 更新日
- 2026-05-29
- 参照範囲
- 公式ドキュメント / man page / 主要ベンダーCLI
- 対象実装
- 主要 Linux / BSD / ネットワーク機器 CLI の一般的な実装
- 免責
- OS とバージョン差分は実環境で確認してください。
このチートシートの使いどころ
Redis 運用チート集は、redis-cli、主要データ型、TTL、SCAN、RDB/AOF、INFO、CLIENT、SLOWLOG、ACL、Sentinel、Redis Cluster の運用コマンドをまとめたチート集。 対象は公式ドキュメント、man page、主要ベンダー CLI で確認できる現行の一般的な実装です。カテゴリは基本、データ型、永続化、運用・監視、クラスタ・レプリカを中心に、40件のコマンドや値を用途別に引けます。障害調査、設定変更前の確認、作業メモ作成で、Redis、redis-cli、cache、キャッシュ、RDBに関連する操作を短時間で探すために使います。
40 / 40
redis-cli -h -pホストとポートを指定して接続する。
redis-cli -h redis.example.com -p 6379redis-cli -nDB 番号を指定する。
redis-cli -n 2 DBSIZEredis-cli --scan本番で安全に key を走査する。
redis-cli --scan --pattern "session:*" | headredis-cli --bigkeys大きい key の傾向を調べる。
redis-cli --bigkeys -h redis.example.comredis-cli --latencyレイテンシを測定する。
redis-cli --latency -h redis.example.comAUTH ACLACL ユーザーで認証する。
redis-cli --user app --pass secret PINGGET SET文字列値を保存・取得する。
SET app:version "2026.05.14" EX 3600
GET app:versionINCRカウンタを原子的に増やす。
INCR rate:user:42LPUSH LRANGEList に投入して読む。
LPUSH queue:mail job-1 job-2
LRANGE queue:mail 0 9BRPOPキューからブロッキング取得する。
BRPOP queue:mail 5SADD SMEMBERSSet を操作する。
SADD online:users alice bob
SMEMBERS online:usersZADD ZRANGESorted Set でランキングを扱う。
ZADD score:daily 120 alice 95 bob
ZRANGE score:daily 0 9 REV WITHSCORESHSET HGETALLHash でオブジェクトを保存する。
HSET user:42 name Alice plan pro
HGETALL user:42XADD XREADGROUPStream にイベントを投入して consumer group で読む。
XADD events * type login user alice
XGROUP CREATE events workers $ MKSTREAM
XREADGROUP GROUP workers c1 COUNT 10 STREAMS events >PFADD PFCOUNTHyperLogLog で概算ユニーク数を数える。
PFADD uv:20260514 alice bob alice
PFCOUNT uv:20260514GEOADD GEOSEARCHGeo index に地点を保存して近傍検索する。GEORADIUS 系は Redis 6.2 から非推奨のため、新規実装では GEOSEARCH / GEOSEARCHSTORE を使う。
GEOADD stores 139.7671 35.6812 tokyo
GEOSEARCH stores FROMLONLAT 139.76 35.68 BYRADIUS 5 kmEXPIRE TTLTTL を設定して残り秒数を確認する。
EXPIRE session:abc 1800
TTL session:abcPERSISTTTL を解除して永続 key に戻す。
PERSIST session:abcKEYS warningKEYS は本番で避け、SCAN を使う。
redis-cli --scan --pattern "cache:*"BGSAVEバックグラウンド RDB 保存を開始する。
BGSAVELASTSAVE最後の RDB 保存時刻を確認する。
LASTSAVEBGREWRITEAOFAOF をバックグラウンドで再構築する。
BGREWRITEAOFCONFIG SET appendonlyAOF を有効化する。
CONFIG SET appendonly yesSAVE configRDB save ポリシーを確認する。
CONFIG GET saveINFO memoryメモリ使用量を確認する。
INFO memoryINFO replicationレプリケーション状態を確認する。
INFO replicationINFO clients接続クライアント数を確認する。
INFO clientsCLIENT LIST接続元と状態を一覧する。
CLIENT LISTCLIENT KILL特定クライアントを切断する。
CLIENT KILL TYPE normal SKIPME yesSLOWLOG GET遅いコマンドを確認する。
SLOWLOG GET 20MONITOR全コマンドを観測する。短時間だけ使う。
redis-cli MONITORMEMORY USAGEkey 単位のメモリ使用量を確認する。
MEMORY USAGE user:42ACL SETUSERACL ユーザーを作成する。
ACL SETUSER app on >secret ~app:* +@read +@write -FLUSHALLREPLICAOFレプリカとして primary へ接続する。
REPLICAOF redis-primary.example.com 6379SENTINEL mastersSentinel の master 認識を確認する。
redis-cli -p 26379 SENTINEL mastersSENTINEL failoverSentinel に手動 failover を指示する。
redis-cli -p 26379 SENTINEL failover mymasterCLUSTER NODESRedis Cluster ノード状態を確認する。
redis-cli -c -h redis-1.example.com CLUSTER NODESCLUSTER SLOTSslot 割当を確認する。
redis-cli -c -h redis-1.example.com CLUSTER SLOTSredis-cli --cluster create3 master 3 replica の cluster を作る。
redis-cli --cluster create 10.0.0.1:6379 10.0.0.2:6379 10.0.0.3:6379 10.0.0.4:6379 10.0.0.5:6379 10.0.0.6:6379 --cluster-replicas 1redis-cli --cluster reshardslot を移動する。
redis-cli --cluster reshard 10.0.0.1:6379 --cluster-from all --cluster-to NODEID --cluster-slots 100| Command | Description | Example | Copy |
|---|---|---|---|
redis-cli -h -p | ホストとポートを指定して接続する。 | redis-cli -h redis.example.com -p 6379 | |
redis-cli -n | DB 番号を指定する。 | redis-cli -n 2 DBSIZE | |
redis-cli --scan | 本番で安全に key を走査する。 | redis-cli --scan --pattern "session:*" | head | |
redis-cli --bigkeys | 大きい key の傾向を調べる。 | redis-cli --bigkeys -h redis.example.com | |
redis-cli --latency | レイテンシを測定する。 | redis-cli --latency -h redis.example.com | |
AUTH ACL | ACL ユーザーで認証する。 | redis-cli --user app --pass secret PING | |
GET SET | 文字列値を保存・取得する。 | SET app:version "2026.05.14" EX 3600
GET app:version | |
INCR | カウンタを原子的に増やす。 | INCR rate:user:42 | |
LPUSH LRANGE | List に投入して読む。 | LPUSH queue:mail job-1 job-2
LRANGE queue:mail 0 9 | |
BRPOP | キューからブロッキング取得する。 | BRPOP queue:mail 5 | |
SADD SMEMBERS | Set を操作する。 | SADD online:users alice bob
SMEMBERS online:users | |
ZADD ZRANGE | Sorted Set でランキングを扱う。 | ZADD score:daily 120 alice 95 bob
ZRANGE score:daily 0 9 REV WITHSCORES | |
HSET HGETALL | Hash でオブジェクトを保存する。 | HSET user:42 name Alice plan pro
HGETALL user:42 | |
XADD XREADGROUP | Stream にイベントを投入して consumer group で読む。 | XADD events * type login user alice
XGROUP CREATE events workers $ MKSTREAM
XREADGROUP GROUP workers c1 COUNT 10 STREAMS events > | |
PFADD PFCOUNT | HyperLogLog で概算ユニーク数を数える。 | PFADD uv:20260514 alice bob alice
PFCOUNT uv:20260514 | |
GEOADD GEOSEARCH | Geo index に地点を保存して近傍検索する。GEORADIUS 系は Redis 6.2 から非推奨のため、新規実装では GEOSEARCH / GEOSEARCHSTORE を使う。 | GEOADD stores 139.7671 35.6812 tokyo
GEOSEARCH stores FROMLONLAT 139.76 35.68 BYRADIUS 5 km | |
EXPIRE TTL | TTL を設定して残り秒数を確認する。 | EXPIRE session:abc 1800
TTL session:abc | |
PERSIST | TTL を解除して永続 key に戻す。 | PERSIST session:abc | |
KEYS warning | KEYS は本番で避け、SCAN を使う。 | redis-cli --scan --pattern "cache:*" | |
BGSAVE | バックグラウンド RDB 保存を開始する。 | BGSAVE | |
LASTSAVE | 最後の RDB 保存時刻を確認する。 | LASTSAVE | |
BGREWRITEAOF | AOF をバックグラウンドで再構築する。 | BGREWRITEAOF | |
CONFIG SET appendonly | AOF を有効化する。 | CONFIG SET appendonly yes | |
SAVE config | RDB save ポリシーを確認する。 | CONFIG GET save | |
INFO memory | メモリ使用量を確認する。 | INFO memory | |
INFO replication | レプリケーション状態を確認する。 | INFO replication | |
INFO clients | 接続クライアント数を確認する。 | INFO clients | |
CLIENT LIST | 接続元と状態を一覧する。 | CLIENT LIST | |
CLIENT KILL | 特定クライアントを切断する。 | CLIENT KILL TYPE normal SKIPME yes | |
SLOWLOG GET | 遅いコマンドを確認する。 | SLOWLOG GET 20 | |
MONITOR | 全コマンドを観測する。短時間だけ使う。 | redis-cli MONITOR | |
MEMORY USAGE | key 単位のメモリ使用量を確認する。 | MEMORY USAGE user:42 | |
ACL SETUSER | ACL ユーザーを作成する。 | ACL SETUSER app on >secret ~app:* +@read +@write -FLUSHALL | |
REPLICAOF | レプリカとして primary へ接続する。 | REPLICAOF redis-primary.example.com 6379 | |
SENTINEL masters | Sentinel の master 認識を確認する。 | redis-cli -p 26379 SENTINEL masters | |
SENTINEL failover | Sentinel に手動 failover を指示する。 | redis-cli -p 26379 SENTINEL failover mymaster | |
CLUSTER NODES | Redis Cluster ノード状態を確認する。 | redis-cli -c -h redis-1.example.com CLUSTER NODES | |
CLUSTER SLOTS | slot 割当を確認する。 | redis-cli -c -h redis-1.example.com CLUSTER SLOTS | |
redis-cli --cluster create | 3 master 3 replica の cluster を作る。 | redis-cli --cluster create 10.0.0.1:6379 10.0.0.2:6379 10.0.0.3:6379 10.0.0.4:6379 10.0.0.5:6379 10.0.0.6:6379 --cluster-replicas 1 | |
redis-cli --cluster reshard | slot を移動する。 | redis-cli --cluster reshard 10.0.0.1:6379 --cluster-from all --cluster-to NODEID --cluster-slots 100 |