Redisが「シングルスレッド」と呼ばれるのは、クライアントから届いたコマンドを1本のメインスレッドが順番に実行する設計だからです。プロセス全体が1スレッドという意味ではなく、ディスクへの書き込みやメモリの解放、Redis 8ではソケットの読み書きも別スレッドが受け持ちます。この記事では、Redis公式ドキュメントと8.10.3のソースをもとに、スレッドの内訳と確かめ方、io-threadsの設定と効く条件を整理しました。後半では、SLOWLOGとLATENCYで重いコマンドを切り分ける手順と、ブロッキングを起こさないコマンドの選び方を実行例で示します。
まとめ:Redisのシングルスレッドはコマンド実行の話で、遅延は重いコマンドから疑う
Redisでシングルスレッドなのはコマンドの実行部分です。1つのコマンドが終わるまで次のコマンドは始まらないため、O(N)のコマンドや長いLuaスクリプトが1本走るだけで、全クライアントの応答が止まります。Redisが遅いと感じたら、ネットワークやCPUの増強より先にSLOWLOG GETで遅いコマンドを探してください。
Redis 8のio-threadsは、ソケットの読み書きとプロトコル解析を別スレッドに逃がす設定です。小さなリクエストが大量に届いてメインスレッドが通信処理で埋まっている場合に効き、重いコマンドそのものは速くなりません。io-threadsは実行中に変更できず、再起動が要ります。
メインスレッドがコマンドの実行で張り付いているなら、io-threadsではなくClusterでデータを分けるか、キーの設計を見直す段階です。
Redisがシングルスレッドで処理する範囲と、裏で動くスレッドの内訳
「シングルスレッドなのに速い」「マルチスレッドに対応した」という説明が混在するのは、どの処理の話かが省かれているためです。
コマンド実行を1本のメインスレッドが順番に処理するという意味
Redis公式の遅延診断ガイドは、Redisを「ほぼ(mostly)シングルスレッド」の設計と説明しています。1つのプロセスが多重化(multiplexing)という手法で全クライアントの要求を受け、ある瞬間に処理できる要求は1つだけで、すべて順番に処理される仕組みです。ガイド自身が、この仕組みはNode.jsとよく似ていると書いています。イベントループの考え方はNode.jsとは?仕組み・版の選び方・標準機能で動かす手順を実装目線で解説でも扱っています。
順番に処理されることの裏返しとして、1コマンドは他のコマンドに割り込まれません。INCRのような単体のコマンドがロック無しで原子的に動くのはこのためです。一方で、遅いコマンドが1本あれば、その間ほかのクライアントは全員待たされます。
bio_lazy_freeなどのBIOスレッドとI/Oスレッド・子プロセスの役割
同じガイドには、Redis 2.4からディスクI/Oなどの遅い処理に別スレッドを使っていると書かれています。8.10.3のソースでは、コマンド以外の処理が次のように分かれています。
| 担当 | 名前(ソース上) | 受け持つ処理 |
|---|---|---|
| メインスレッド | redis-server | コマンドの実行、期限切れキーの削除 |
| BIOスレッド | bio_close_file | ファイルのクローズ |
| BIOスレッド | bio_aof | AOFのfsync |
| BIOスレッド | bio_lazy_free | UNLINKなどの非同期のメモリ解放 |
| I/Oスレッド | io_thd_1〜 | ソケットの読み書き(io-threads 2以上) |
| 子プロセス | fork | RDBの保存、AOFの書き直し |
名前はbio.cとiothread.cの定義どおりです。RDBの保存は子プロセスが担いますが、forkの呼び出し自体はメインスレッドで行われます。ガイドの試算では24GBのインスタンスでページテーブルが48MBになり、そのコピーの間はコマンドが止まります。
パイプラインで毎秒100万リクエストを返せる理由とCPUが詰まらない前提
1スレッドでも速いのは、データがメモリ上にあり、1コマンドの処理が短いからです。Redis FAQは、CPUがボトルネックになることは少なく、通常はメモリかネットワークが先に詰まると説明しています。パイプラインを使えば、平均的なLinuxで毎秒100万リクエストを処理できるという記述もあります。
ベンチマークのドキュメントには、MacBook Airで16コマンドずつパイプライン化した測定例があり、SETが毎秒1,536,098、GETが毎秒1,811,594です。この数字の前提は、O(1)の軽いコマンドをパイプラインでまとめて送ることです。同じドキュメントは、Redisはコマンド実行の面でほぼシングルスレッドで、複数コアを使うには複数インスタンスを立てる設計だとも明記しています。
psとINFOでredis-serverのスレッド構成とCPUの偏りを確かめる手順
動いているサーバーで、スレッドの実体を数えます。どちらの手順もサーバーを止めずに実行できます。
ps -Tでredis-serverのスレッド名を並べ、何本動いているか数える
Linuxではpsの-Tでスレッドごとの行を出せます。Redisはスレッドに名前を付けているため、comm列で役割が分かります。
# redis-server のスレッドを名前つきで並べる(Linux)
ps -T -p "$(pidof redis-server)" -o spid,comm,pcpu
# スレッドごとのCPU使用率を毎秒見る
top -H -p "$(pidof redis-server)"
io-threadsが既定の1なら、メインスレッドとbio_で始まる3本が並び、io_thd_は出ません。io-threads 4にするとio_thd_1からio_thd_3の3本が加わります。iothread.cはスレッド番号1から「設定値−1」まで作る実装で、番号0がメインスレッドです。top -Hでメインスレッドだけが100%近くに張り付き、他が遊んでいれば、ボトルネックはメインスレッドにあります。
INFO cpuとINFO threadsでメインスレッドとI/Oスレッドの負荷を読む
psを打てないマネージド環境では、INFOコマンドで同じことを確かめます。
# プロセス全体とメインスレッドのCPU消費(秒)を比べる
redis-cli INFO cpu
# I/Oスレッドごとの担当クライアント数と読み書き回数(Redis 8.0から)
redis-cli INFO threads
# I/Oスレッドが有効か、処理した読み書きイベントの累計
redis-cli INFO stats | grep -E 'io_threads_active|io_threaded'
used_cpu_userはプロセス全体、used_cpu_user_main_threadはメインスレッドだけの値です。数十秒あけて2回取り、差分の大半がメインスレッドなら、コマンドの実行か通信処理がメインスレッドに集中しています。threads節は8.0で追加され、io_thread_1:clients=…,reads=…,writes=…の形でスレッドごとに出ます。
Redis 8のio-threadsでソケットの読み書きを並列にする設定と効く条件
io-threadsはRedis 6.0から存在する設定で、Redis 8.0で実装が入れ替わりました。古い記事の手順をそのまま使うと、効かない項目を設定することになります。
redis.confのio-threadsをコア数より1少なく設定し、再起動で反映する
8.10.3のredis.confは、スレッド化は既定で無効、4コア以上のマシンで少なくとも1コアを空けて使うよう勧めています。目安は4コアなら3、8コアなら7です。CPUを大きく使うほどの性能問題が無ければ使う意味は無い、とも書かれています。
# redis.conf(4コアのマシンの例)
io-threads 3
# Dockerなら起動引数で渡す
docker run -d --name redis -p 6379:6379 redis:8.10 redis-server --io-threads 3
# 反映を確かめる
redis-cli CONFIG GET io-threads
config.cでは、io-threadsは変更不可(IMMUTABLE)の設定として定義され、範囲は1〜128、既定は1です。実行中にCONFIG SET io-threadsを打ってもエラーになるため、設定ファイルを書き換えて再起動します。レプリカから順に再起動し、フェイルオーバーで入れ替える段取りにしてください。
Redis 8.0の非同期I/Oスレッドとio-threads-do-readsの廃止
PR #13695によると、6.0のI/Oスレッドは、メインスレッドがI/Oスレッドの読み書き完了を待つ同期的な仕組みでした。8.0の実装では各I/Oスレッドが独自のイベントループを持ち、メインスレッドはコマンドの処理に専念します。TLSの処理もI/Oスレッドへ移りました。
この変更はRedis 8.0.0(2025年5月2日公開)のリリースノートに、新しいI/Oスレッドの実装として載っています。先行した8.0-M03のノートには、io-threads-do-readsが効かなくなり、読み書きの両方を常にスレッドで扱うとあります。7.x向けの記事にあるio-threads-do-reads yesは、8系では書いても意味がありません。PRは、コマンドの実行は従来どおりすべてメインスレッドで行うとも明記しています。
redis-benchmarkの–threadsで設定前後のスループットを比べる手順
redis.confは、効果を測るときはredis-benchmark側も--threadsでスレッドを使うよう注意しています。クライアントが1スレッドのままだと、測っているのはクライアントの限界です。
# 別のマシンから、io-threads 1 と 3 で同じ条件を流して比べる
redis-benchmark -h 10.0.0.10 -t set,get -n 1000000 -c 200 -d 256 --threads 4 -q
# アプリの実態に近いパイプライン長も試す
redis-benchmark -h 10.0.0.10 -t set,get -n 1000000 -c 200 -P 16 --threads 4 -q
サーバーと同じマシンでbenchmarkを動かすとCPUを奪い合うため、測定は別のマシンから行います。
I/Oスレッドを増やしても速くならない重いコマンド中心の負荷
I/Oスレッドが肩代わりするのは、ソケットの読み取り、プロトコルの解析、応答の書き込みです。SORTや大きな集合のSUNION、KEYSのように実行そのものが重いコマンドは、メインスレッドで走る時間が変わりません。
2コアのような小さいインスタンスで有効にしても、メインスレッドとCPUを取り合うだけです。io-threadsを検討する条件は、4コア以上で、SLOWLOGに目立つコマンドが無く、接続数が多くてメインスレッドの消費が高い場合に絞ります。
重いコマンドのブロッキングをSLOWLOGとLATENCYで切り分ける手順
シングルスレッドの弱点は、遅いコマンド1本が全体を止めることです。どのコマンドが止めているかは、Redis自身の記録で特定できます。
SLOWLOGのしきい値を1ミリ秒に下げて遅いコマンドを記録する設定
SLOWLOGは、実行時間がしきい値を超えたコマンドを記録する仕組みです。8.10.3の既定はしきい値slowlog-log-slower-than 10000(マイクロ秒=10ミリ秒)、保持件数slowlog-max-len 128です。キャッシュ用途では10ミリ秒は長すぎるため、調査中は1ミリ秒に下げます。
# 1ミリ秒(1000マイクロ秒)以上かかったコマンドを記録し、512件まで残す
redis-cli CONFIG SET slowlog-log-slower-than 1000
redis-cli CONFIG SET slowlog-max-len 512
# 直近10件を見る(-1 で全件)
redis-cli SLOWLOG GET 10
redis-cli SLOWLOG LEN
SLOWLOG GETのドキュメントによると、各エントリは連番のID、実行時刻、実行時間(マイクロ秒)、引数、クライアントのIPとポート、クライアント名の6つで、Redis 8.10で引数の総数が7つ目に加わりました。引数はslowlog-max-argc(既定32)を超えると切り詰められます。IDは再起動まで戻らないため、監視スクリプトは前回のIDより大きいものだけを通知に回せます。
SLOWLOGに出ない遅延をLATENCY DOCTORとcommandstatsで拾う
SLOWLOGの実行時間には、クライアントとの通信や応答の送信は含まれません。ドキュメントは、コマンドの実行こそがスレッドを止めて他の要求に応えられなくなる唯一の段階だから、と理由を書いています。forkや期限切れキーの一斉削除による停止は、SLOWLOGには残りません。
# 100ミリ秒以上の停止を記録する(既定は0で無効)
redis-cli CONFIG SET latency-monitor-threshold 100
# イベントごとの直近の停止と、人が読める診断
redis-cli LATENCY LATEST
redis-cli LATENCY DOCTOR
# コマンド種別ごとの呼び出し回数と平均実行時間
redis-cli INFO commandstats
LATENCYの監視はRedis 2.8.13からの機能で、command・fork・expire-cycle・eviction-cycleなどのイベント別に停止を記録します。commandstatsはcmdstat_get:calls=…,usec=…,usec_per_call=…の形で、1回あたりは速くても呼び出し回数が多く合計時間を食っているコマンドが見つかります。
KEYS・大きいキーのDEL・Luaスクリプトが全クライアントを止める仕組み
遅延診断ガイドは、本番でのKEYSの実行を、遅いコマンドによる遅延の非常によくある原因に挙げています。キーを探すならSCANを使います。手順はredis-cliの使い方:接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧にまとめました。
見落とされやすいのがDELです。redis.confは、DELはブロッキングで、要素の多いキーを消すと解放が終わるまで止まると説明しています。UNLINKなら解放はbio_lazy_freeスレッドに回ります。
# 大きいキーは UNLINK で消す
redis-cli UNLINK report:2026-10:all
# 既存コードのDELをUNLINKと同じ動きにする(8.10.3の既定は no)
redis-cli CONFIG SET lazyfree-lazy-user-del yes
lazyfree.cでは、解放の手間が64を超えるオブジェクトだけを別スレッドへ回し、小さいキーはその場で解放します。Luaスクリプトは、プログラマビリティのドキュメントのとおり実行中はサーバー全体を止めます。既定5秒(busy-reply-threshold)を超えると他のクライアントにはBUSYエラーが返り、書き込み済みのスクリプトはSHUTDOWN NOSAVEでしか止められません。ガイドは、同じ秒に大量のキーの期限が切れる設計も停止の原因になると警告しています。
シングルスレッドを前提にしたコマンド選びと、スケールの判断基準
シングルスレッドは制約であると同時に、設計を単純にしてくれる性質でもあります。
1コマンドの原子性に頼れる範囲と、GETとSETの間の競合を防ぐ書き方
原子性が保証されるのは1コマンドの中だけです。アプリでGETして値を計算しSETで書き戻すと、その間に他のクライアントのコマンドが入ります。在庫を1つ減らす処理なら、条件判定まで1回の実行に収めます。
# NG:GETとSETの間に他のクライアントが割り込める
# OK:残りが1以上のときだけ減らす処理を、1回のスクリプト実行に収める
redis-cli EVAL "local v = tonumber(redis.call('GET', KEYS[1]) or '0') if v > 0 then return redis.call('DECR', KEYS[1]) end return -1" 1 stock:1001
このスクリプトは数マイクロ秒で終わるため、全体を止める心配はありません。逆に、ループで数万件を処理するスクリプトはシングルスレッドの弱点をそのまま突くので、アプリ側で分割します。キャッシュでの使い方はRedisキャッシュの実装方法:Cache-AsideとTTL設計・スタンピード対策をredis-pyのコードで解説で扱っています。
メインスレッドの使い道でio-threadsとClusterのどちらで分けるか決める
メインスレッドが張り付いたときの打ち手は、何に使われているかで決まります。判断は次の順で行います。
- SLOWLOGとcommandstatsに重いコマンドがあれば、まずそれを直す(KEYSをSCANへ、DELをUNLINKへ、大きいキーを分割)
- 重いコマンドが無く、4コア以上で接続数が多いなら、io-threadsを有効にして測る
- io-threadsを入れてもメインスレッドが張り付くなら、Clusterでキーを複数のプライマリに分ける
2コア以下のインスタンスでio-threadsを有効にする構成と、重いコマンドを残したままのスケールアウトは採用しません。どちらも費用だけ増えて止まる原因が残ります。Clusterの組み方はRedis Clusterの構築手順:16384ハッシュスロットの仕組みとMOVED・ASKで解説しました。キーの持ち方やデータ層の分け方から見直す必要があるなら、データベース設計・移行支援で、現行のアクセス傾向とキー構成の棚卸しから相談を受けています。
よくある質問
Redisのシングルスレッドについて、検索されることの多い質問に答えます。
Redisは今も本当にシングルスレッドだけで動いているのですか?
コマンドの実行は、Redis 8.10系でも1本のメインスレッドが担当しています。一方で、AOFのfsyncやUNLINKのメモリ解放はBIOスレッドが、Redis 8でio-threadsを2以上にした場合はソケットの読み書きをI/Oスレッドが受け持ちます。プロセスとしては複数スレッドで動いており、「シングルスレッド」はコマンド実行の性質を指す言葉だと捉えてください。
Redisをマルチスレッドで動かす設定はどのバージョンから使えますか?
ソケットの読み書きをスレッド化するio-threadsはRedis 6.0から使えます。Redis 8.0で非同期のI/Oスレッドに実装が入れ替わり、io-threads-do-readsは廃止されて読み書きの両方が常にスレッド化されるようになりました。どの版でもコマンドの実行自体はメインスレッドのままで、コマンドを並列に実行する設定はありません。
io-threadsは実行中のRedisにCONFIG SETで変更できますか?
変更できません。8.10.3のconfig.cでio-threadsは変更不可の設定として定義されており、CONFIG SETはエラーになります。redis.confか起動引数の--io-threadsで指定し、再起動して反映してください。現在値はCONFIG GET io-threadsで、実際にスレッドが動いているかはINFO threadsで確かめられます。
シングルスレッドなら複数クライアントの同時更新で競合は起きませんか?
1つのコマンドの途中に他のコマンドが割り込むことはありません。ただし、アプリでGETしてから計算してSETするように複数のコマンドにまたがる処理では、間に他のクライアントの更新が入ります。INCRのような1コマンドで済む形にするか、LuaスクリプトやWATCHとMULTIで1つの単位にまとめてください。
Redisから分かれたValkeyでもシングルスレッドの考え方は同じですか?
同じです。Valkeyも8.0でI/Oスレッドを非同期化しましたが、コマンドの実行はメインスレッドのままで、io-threadsの既定値も1です。違いと導入手順はValkeyとは?Redisとの違い・Streamsの使い方と導入手順にまとめています。
関連記事
- Redisとは:仕組みとデータ型・Redis 8.10系の新機能とライセンス、Dockerで動かす手順:Redis本体の仕組みと版・ライセンス
- redis-cliの使い方:接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧:–latencyや–bigkeysでの調査
- Redis Clusterの構築手順:16384ハッシュスロットの仕組みとMOVED・ASK、redis-pyでの接続と再シャーディング:メインスレッドの限界を超えて分割する方法
- Redisキャッシュの実装方法:Cache-AsideとTTL設計・スタンピード対策をredis-pyのコードで解説:期限切れの集中を避けるTTL設計
- Valkeyとは?Redisとの違い・Streamsの使い方と導入手順:Valkey 8のI/Oスレッド