Redisの容量は、データを置くメモリの上限を決めるmaxmemoryで管理します。64ビット版の既定値は0で、上限を設けずにサーバーのメモリを使い切るまで増え続けます。この記事では、Redis公式ドキュメントとAWSの資料をもとに、上限に達したときの挙動、INFO memoryの読み方、キー1件のバイト数を測って全体を見積もる手順を整理しました。後半では、forkやレプリカ用バッファの分を含めたmaxmemoryの決め方と、増設の前に試すメモリ削減、スケールの判断までを設定例とコードで示します。
まとめ:Redisの容量はピーク時のデータ量と永続化の余白から逆算して決める
本番のRedisにはmaxmemoryの設定が必須です。値は「キー1件の実測バイト数×計画件数」で出したデータ量を下限に、搭載メモリから永続化とレプリケーションの余白を引いて決めます。書き込みの多い用途でRDBやAOFを使うなら、保存中は通常の最大2倍までメモリが膨らむと公式は説明しています。
上限に達したときの動きはmaxmemory-policyで決まり、既定のnoevictionでは書き込みがOOMエラーになります。正本のデータを置くなら既定のまま監視で増設を判断し、キャッシュ専用ならallkeys系で古いキーを追い出します。
ElastiCacheでは25%の予約メモリが既定で差し引かれており、ノードの表示容量がそのまま使えるわけではありません。
Redisの容量を決めるmaxmemoryの既定値と、上限に達したときの挙動
容量の話は、上限が無い状態と、上限に達した状態の2つを分けると整理できます。
64ビット版は既定で上限なし、noevictionで書き込みがOOMになる仕組み
エビクションの公式ドキュメントによると、maxmemoryを0にするとデータ量に上限を設けず、これが64ビット環境の既定です。32ビット環境には暗黙の3GBの上限があります。上限が無いまま使い続けると、メモリを使い切った時点でLinuxのOOM killerにプロセスを止められます。
上限を設けた場合、8.10.3のredis.confの既定ポリシーはnoevictionです。このとき、データを増やすコマンドは次のエラーで失敗します。
> SET newkey "value"
(error) OOM command not allowed when used memory > 'maxmemory'.
> GET oldkey
"value"
OOMエラーの公式解説のとおり、読み取りと削除のコマンドは引き続き動きます。redis-pyではOutOfMemoryErrorとして例外が上がるため、アプリ側でこの例外を拾い、書き込みの失敗をログに残してください。
maxmemoryに数えないレプリカ用バッファとforkで増えるメモリの内訳
maxmemoryはプロセス全体の上限ではありません。同じドキュメントは、レプリカやAOFへ送る更新を貯めるバッファをmaxmemoryとの比較から外していると説明しています。追い出しで生まれた更新がバッファを膨らませ、さらに追い出しが走る循環を防ぐためです。この量はINFO memoryのmem_not_counted_for_evictで確かめられます。
もう1つの上乗せがforkです。RDBの保存もAOFの書き換えも、子プロセスを作ってコピーオンライトで書き出します(永続化の公式ドキュメント)。運用ガイドは、書き込みの多い用途では保存中に通常の最大2倍のメモリを使うことがあると書いています。増える量は保存中に書き換えられたページ数に比例し、同じガイドは次のカーネル設定も勧めています。
# forkの失敗を防ぐ(運用ガイドの推奨値)
echo 'vm.overcommit_memory = 1' | sudo tee -a /etc/sysctl.conf
sudo sysctl vm.overcommit_memory=1
# Transparent Huge Pagesを無効にする
echo never | sudo tee /sys/kernel/mm/transparent_hugepage/enabled
運用ガイドはスワップも有効にしておくよう勧めています。スワップが無いとメモリを使い切った瞬間にプロセスが落ち、スワップがあれば遅延の悪化として兆候をつかめるからです。
INFO memoryとMEMORY USAGEでRedisの使用量を確かめる手順
見積もりの材料は、今のサーバーの数字とキー1件の実測値の2つです。どちらも稼働中に取れます。
used_memoryとRSS・peakの差から断片化と解放待ちを読む方法
まずINFOコマンドで容量に関わる項目だけを抜き出します。
redis-cli INFO memory | grep -E '^(used_memory|used_memory_rss|used_memory_peak|used_memory_dataset|used_memory_overhead|mem_fragmentation_ratio|allocator_frag_ratio|mem_not_counted_for_evict|maxmemory|maxmemory_policy):'
redis-cli INFO stats | grep -E '^(evicted_keys|expired_keys|total_eviction_exceeded_time):'
| 項目 | 意味 | 見るときの基準 |
|---|---|---|
| used_memory | Redisがアロケータから確保した総量 | maxmemoryと比べる値 |
| used_memory_rss | OSから見たプロセスの使用量 | サーバーの空きと比べる値 |
| used_memory_peak | 起動以降の最大値 | 見積もりの基準 |
| used_memory_dataset | 管理領域を除いたデータ部分 | キー1件の平均の検算 |
| mem_fragmentation_ratio | RSS÷used_memory | 1を大きく超えたら断片化を疑う |
| evicted_keys | 上限で追い出したキー数 | 正本用途なら0のはず |
公式の説明では、RSSはused_memoryより少し大きい状態が理想です。逆にused_memoryがRSSより大きいときは一部がスワップに出ており、大きな遅延を覚悟する場面です。比率が高いときは、本当の外部断片化を示すallocator_frag_ratioを合わせて確認します。
キーを消してもRSSが下がらないのは不具合ではありません。メモリ削減のガイドには、5GBのデータから2GB分を消してもRSSは5GB前後のまま残る例があり、だからこそ容量はピークで見積もるよう求めています。
MEMORY USAGEとSCANでキー1件あたりのバイト数を実測するコード
MEMORY USAGEは、キーと値の保存に要するバイト数を管理領域込みで返すコマンドで、Redis 4.0から使えます。公式の例では、Redis 7.2の64ビット版とjemallocで空文字列のキーが56バイト、100文字の値を持つキーが160バイトでした。データが空でも数十バイトの管理領域が付く点が、値の長さだけで見積もると外れる理由です。
次のPythonコードは、プレフィックスごとにSCANで最大1,000件を取り、平均バイト数に計画件数を掛けます。
# SCANでサンプルを取り、1件あたりの平均バイト数から全体を見積もる(redis-py)
import itertools
import redis
r = redis.Redis(host="localhost", port=6379)
GIB = 1024 ** 3
def estimate(pattern, planned_keys, sample=1000):
keys = itertools.islice(r.scan_iter(match=pattern, count=500), sample)
sizes = [s for s in (r.memory_usage(k) for k in keys) if s is not None]
if not sizes:
return 0
avg = sum(sizes) / len(sizes)
total = avg * planned_keys
print(f"{pattern}: n={len(sizes)} avg={avg:.0f}B max={max(sizes)}B "
f"planned={planned_keys:,} total={total / GIB:.2f}GiB")
return total
# 計画件数はアプリの想定値を入れる(下は例)
dataset = estimate("session:*", 2_000_000) + estimate("cache:product:*", 500_000)
print(f"dataset={dataset / GIB:.2f}GiB")
ハッシュやリストのような集約型では、MEMORY USAGEは既定で要素を5つだけ抽出して推定します。要素数のばらつきが大きいキーはMEMORY USAGE key SAMPLES 0で全件を数えてください。Redis 8.10からは、共有テンプレートを使う小さいハッシュについて、テンプレートの按分も加算されるようになりました。全キーを走査して大きいものを並べたいときは、redis-cliの使い方:接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧で紹介した--memkeysが向いています。
キー数と値の大きさから必要メモリを見積もり、maxmemoryを決める計算
実測値が出たら、余白を足してmaxmemoryと搭載メモリを決めます。
実測値×計画件数にピークと永続化の余白を足すメモリ容量の見積もり式
計算は3段で行います。
- データ量=キー1件の平均バイト数×ピーク時の件数(プレフィックスごとに合算)
- maxmemory=データ量に、件数の伸びと大きな集合演算の一時的な超過を見込んだ上乗せを足す
- 搭載メモリ=maxmemoryに、OS・クライアントのバッファ・断片化・forkの分を足す
計算例を示します。1件平均300バイトのキーが500万件なら、データ量は15億バイトで約1.4GiBです。運用ガイドは「10GBの空きがあるなら8か9に設定する」と書いており、管理領域と断片化に1〜2割を残す比率になります。書き込みの多い用途でRDBやAOFを有効にするなら、保存中の2倍化に備えて搭載メモリはmaxmemoryの2倍を確保します。
永続化を切ったキャッシュ専用なら、2倍の余白は不要です。ただしレプリケーションを組むと、ディスクレス複製でない限り、永続化を切っていてもRDBの保存が走ると運用ガイドは注意しています。見落とすと、レプリカを追加した時点でプライマリのメモリが急に増えます。
ElastiCacheの予約メモリ既定25%と自前運用での余白計算の違い
マネージドサービスでは、余白の計算の一部をサービス側が持っています。AWSの予約メモリの資料によると、ElastiCacheはreserved-memory-percentを既定で25%とし、ノードの表示容量からこの分を引いた値をmaxmemoryにします。表示容量13.5GBのノードなら、使えるのは約10.1GBです。
AWSはこの値を下げないよう明記しており、small系は30%、micro系は50%への引き上げを勧めています。forkを伴う保存でメモリが2倍以上になる場合があり、空きが足りないとforkを使わない保存方式に切り替わってクライアントの遅延が増えるためです。変更はカスタムパラメータグループで行います。
# 予約メモリを30%にしたパラメータグループを作る(ファミリーはエンジンの版に合わせる)
aws elasticache create-cache-parameter-group \
--cache-parameter-group-name my-redis-reserved30 \
--cache-parameter-group-family redis7 \
--description "reserved memory 30 percent"
aws elasticache modify-cache-parameter-group \
--cache-parameter-group-name my-redis-reserved30 \
--parameter-name-values "ParameterName=reserved-memory-percent,ParameterValue=30"
EC2に自前で立てる場合は、この25%に相当する余白を自分で引く必要があります。サービスの選び分けはAWSでRedisを使う方法:ElastiCache・MemoryDB・EC2の選び分けと接続手順にまとめました。
maxmemoryとエビクションポリシーを用途ごとに決める設定例と単位の注意
値が決まったら、設定ファイルと稼働中のサーバーの両方に入れます。
正本はnoeviction、キャッシュはallkeys系にする用途の線引き
ポリシーはnoevictionのほか、LRU・LFU・LRM・ランダムをallkeysとvolatileで組み合わせた計10種があります。容量設計の観点で先に決めるのは、追い出しを許すかどうかです。セッションやジョブキューのように消えると困るデータを置くならnoevictionのまま、上限の手前で警告を出して増設します。キャッシュ専用ならallkeys-lruから始めます。
注意したいのがvolatile系です。TTL付きのキーが1つも無いとnoevictionと同じ動きになり、追い出すつもりでOOMエラーを招きます。キャッシュでのポリシーの選び分けとヒット率の測り方はRedisキャッシュの実装方法:Cache-AsideとTTL設計・スタンピード対策をredis-pyのコードで解説で扱っています。
maxmemoryの設定ファイル編集と稼働中の変更・再起動後の保持手順
maxmemoryの変更方法は、redis.confの編集と稼働中のCONFIG SETです。稼働中の変更に再起動は要らず、CONFIG REWRITEで設定ファイルに書き戻せます。
# redis.conf(搭載8GB・永続化ありで、上の式から4GBにした例)
maxmemory 4gb
maxmemory-policy noeviction
# 稼働中に変える場合
redis-cli CONFIG SET maxmemory 4gb
redis-cli CONFIG GET maxmemory
# 稼働中の変更を redis.conf に書き戻す
redis-cli CONFIG REWRITE
単位には落とし穴があります。8.10.3のredis.confの説明では、1gは10億バイト、1gbは1024の3乗バイトです。4gと書くと4gbより約7%小さくなります。CONFIG SETだけでは再起動で元に戻るため、CONFIG REWRITEで設定ファイルへ残してください。Dockerで設定ファイルをマウントする構成はRedisをDockerで動かす手順:compose.yamlでの永続化・redis.conf・パスワード設定を参照してください。
追い出しの精度はmaxmemory-samples(既定5)で調整します。公式によれば10にすると本来のLRUにかなり近づき、その代わりCPUを多く使います。
容量が足りなくなったときに増設より先に試すRedisのメモリ削減手順
増設は費用が続くので、同じデータを小さく持てないかを先に確かめます。
小さいハッシュのlistpack化で同じデータを数分の1に収める方法
メモリ削減のガイドによると、要素数と要素サイズが一定以下のハッシュ・ソート済み集合・集合は省メモリの形式で保存され、使用量は最大で10分の1、平均で5分の1になります。Redis 7.0以降の既定の閾値は次のとおりです。
| 型 | 要素数の上限 | 要素サイズの上限 | 設定名の接頭辞 |
|---|---|---|---|
| ハッシュ | 512 | 64バイト | hash-max-listpack |
| ソート済み集合 | 128 | 64バイト | zset-max-listpack |
| 整数だけの集合 | 512 | なし | set-max-intset |
| 集合(7.2以降) | 128 | 64バイト | set-max-listpack |
設定名は接頭辞の後ろに-entries(要素数)か-value(要素サイズ)を付けた形で、たとえばハッシュの要素数はhash-max-listpack-entriesです。ユーザー情報をuser:1001:nameのように項目ごとの文字列キーに分けているなら、1つのハッシュにまとめるだけで管理領域が減ります。ガイドには、10万件を文字列キーで持つと11MB、ハッシュに束ねると1.7MBになったRedis 2.2での例があります。古い版の数字なので、今の版では先のコードで実測してください。
# 閾値と、キーが省メモリ形式のままかを確かめる
redis-cli CONFIG GET 'hash-max-listpack-*'
redis-cli OBJECT ENCODING user:1001
redis-cli MEMORY USAGE user:1001
OBJECT ENCODINGがhashtableを返したら、閾値を超えて通常の形式に変わっています。
TTLの付け忘れと大きいキーの調査・削除後に行うメモリ断片化の確認
容量が増え続ける原因で多いのは、TTLを付け忘れたキーの蓄積です。INFO keyspaceのkeysとexpiresを比べ、TTL付きの割合が想定より低ければ書き込み側のコードを直します。
# DBごとのキー数とTTL付きキー数
redis-cli INFO keyspace
# 大きいキーはUNLINKで消す(解放は別スレッド)
redis-cli UNLINK report:2026-10:all
# メモリまわりの問題を文章で報告させる
redis-cli MEMORY DOCTOR
要素の多いキーをDELで消すと、解放が終わるまで他のコマンドが止まります。UNLINKを使う理由はRedisのシングルスレッドとは:io-threadsの設定とSLOWLOGで遅いコマンドを切り分ける手順で説明しました。MEMORY DOCTORは、断片化やピークとの差といった兆候を文章で返すので、数値を読む前の当たり付けに向きます。
スケールアップ・Cluster分割・設計見直しを分ける容量の判断基準
削減を試しても足りないときの打ち手は、データの伸び方で決まります。
1台で持てる量を超える前にClusterへ分ける条件と見送る場面
判断は次の順で行います。
- evicted_keysが正本用途で0を超えた、またはused_memoryがmaxmemoryの8割を超えたら、まず削減の章を当てる
- 削減後も1年以内に上限へ届く見込みなら、インスタンスを1段大きくする
- 1台の搭載メモリでは持ちきれない、または保存時の2倍化が許容できない大きさなら、Clusterでキーを複数のプライマリに分ける
数GBのデータでClusterを組む構成は採用しません。複数キーをまたぐ操作に制約が付き、運用の手間が容量の利点を上回ります。逆に、数十GBのデータを1台に積み、forkのたびに遅延が出ている状態を放置するのも見送るべき判断です。Clusterの組み方はRedis Clusterの構築手順:16384ハッシュスロットの仕組みとMOVED・ASK、redis-pyでの接続と再シャーディングで解説しました。キーの持ち方やRDBとの役割分担から見直す必要があるなら、データベース設計・移行支援で、現行のキー構成と使用量の棚卸しから相談を受けています。
よくある質問
Redisの容量とメモリ設定について、検索されることの多い質問に答えます。
Redisに保存できるデータ容量の上限はいくつですか?
64ビット版のRedisにはデータ量の固定の上限が無く、maxmemoryを設定しなければサーバーのメモリを使い切るまで増えます。32ビット版は4GBまでで、暗黙の上限として3GBが設定されます。実際の上限は、搭載メモリからOS・バッファ・forkの分を引いた値です。1台に収まらない量はClusterで複数のプライマリに分けて持ちます。
maxmemoryは搭載メモリの何割に設定すればよいですか?
公式の運用ガイドは、10GBの空きがあるなら8か9に設定するよう勧めています。書き込みの多い用途でRDBやAOFを使う場合は、保存中に最大2倍までメモリを使うため、搭載メモリの半分程度に抑えます。ElastiCacheでは25%の予約メモリが既定で差し引かれるので、自分で割り引く必要はありません。
OOM command not allowedが出たときはどう対処しますか?
まずINFO memoryでused_memory_humanとmaxmemory_human、maxmemory_policyを確かめます。キャッシュ用途ならallkeys-lruなどのポリシーに変え、正本用途なら不要なキーの削除かmaxmemoryの引き上げで対処します。volatile系のポリシーでTTL付きのキーが無い場合も同じエラーになるので、TTLの付け忘れも疑ってください。
キーを削除したのにメモリ使用量が減らないのはなぜですか?
Redisが解放したメモリは、アロケータが保持したままOSへ返さないことが多いためです。used_memoryは下がってもRSSはピーク時の大きさに近いまま残ります。アロケータはその領域を次の書き込みで再利用するので、同じ量を書き戻してもRSSは増えません。このため容量はピーク時の使用量で見積もります。
レプリカのmaxmemoryはプライマリと同じでよいですか?
同じか、それ以上にしてください。8.10.3のredis.confではreplica-ignore-maxmemoryが既定でyesで、Redis 5以降のレプリカは自分のmaxmemoryを無視します。フェイルオーバーでレプリカがプライマリに昇格すると上限が効き始めるので、小さいメモリのレプリカは昇格直後に追い出しやOOMエラーを起こします。冗長構成の組み方はRedisの冗長化:レプリケーションとSentinelで自動フェイルオーバーを組む設定例にまとめました。
関連記事
- Redisとは:仕組みとデータ型・Redis 8.10系の新機能とライセンス、Dockerで動かす手順:Redis本体の仕組みと版・ライセンス
- Redisキャッシュの実装方法:Cache-AsideとTTL設計・スタンピード対策をredis-pyのコードで解説:エビクションポリシーの選び方とヒット率
- redis-cliの使い方:接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧:–memkeysでの大きいキーの調査
- Redis Clusterの構築手順:16384ハッシュスロットの仕組みとMOVED・ASK、redis-pyでの接続と再シャーディング:1台の容量を超えたときの分割
- AWSでRedisを使う方法:ElastiCache・MemoryDB・EC2の選び分けと接続手順:マネージドサービスでのノード選び