ヒープまたはバッファプールに加え、ネイティブメモリ、ページキャッシュ、スレッド、リカバリのオーバーヘッド分を見込んでメモリを予算化します。表示されるヒープはコンテナ全体の合計ではありません。
これは、JVMアプリとデータベースがNASのページキャッシュと競合する共有ホームサーバーで重要です。運用上のリスクは、ヒープサイズと同じ値に制限を設定するとOOMキルが発生し、制限を設けないと1つのワークロードが他のすべてのサービスを追い出してしまうことです。保存済みのベースラインから始め、可逆的な変更を一度に1つだけ行い、観測された状態が意図した設定パスと一致しなくなった時点で停止します。
JVMとデータベースのコンテナメモリ制限のベースラインを確立する
設定を変更する前に、コンテナのワーキングセット、RSS、ページキャッシュ、JVMのネイティブメモリ、データベースのバッファ、スワップ、OOMイベント、ピーク負荷時のレイテンシを記録します。元の設定と本番に近い1回の実行結果を保存し、後の改善をアイドル状態や異なる負荷ではなく、同じワークロードで比較できるようにします。
現在のコンテナのメモリ制約を使用して、サポートされている制御とそのセマンティクスを確認します。デフォルト値は既知の出発点として扱い、このサーバー、クライアント構成、リカバリ目標に適合する設定であることの証拠とはみなさないでください。
編集する前に、受け入れ条件と停止条件を定義します。受け入れシグナルは、ログ、プロトコル状態、アプリケーション出力、または復元されたデータで確認できる必要があります。停止条件は、アクセス範囲の拡大、データ損失、リソース枯渇、または次の復旧時間枠を使い切る障害を防ぐものでなければなりません。
JVMとデータベースのコンテナメモリ制限の変更を管理された段階で適用する
ステップ1: 上限を設けない状態で、ただし制御されたピークワークロードを測定し、回収可能なキャッシュと回収不可能な常駐メモリを分離します。変更後は、期待した状態が現れているか直ちに確認します。現れなければ、次のステップを適用する前にこのステップを元に戻します。
ステップ2: アプリケーションを考慮したヒープまたはバッファの目標値をコンテナ制限より低く設定し、カーネルとストレージキャッシュのためにホストメモリを確保します。変更後は、期待した状態が現れているか直ちに確認します。現れなければ、次のステップを適用する前にこのステップを元に戻します。
ステップ3: ハードリミットの前に警告しきい値を追加し、継続的な圧力が発生したら同時実行数を減らします。変更後は、期待した状態が現れているか直ちに確認します。現れなければ、次のステップを適用する前にこのステップを元に戻します。
services:
app:
mem_limit: 4g
environment:
JAVA_TOOL_OPTIONS: "-Xms1g -Xmx3g"
成功、失敗、例外の分岐を解釈する
成功とは、スワップスラッシング、OOMキル、ストレージレイテンシの悪化なしに、ピークワークロードが警告マージンを下回ることです。結果を生み出した正確なワークロード、バージョン、タイミングを記録します。より軽いテストは、元の問題が解決した証拠にはなりません。
失敗とは、カーネルがプロセスを強制終了する、JVMがネイティブメモリを確保できない、またはデータベースが有用なキャッシュを繰り返し追い出すことです。隣接するすべての制御を弱めて補おうとしないでください。最後の正常なベースラインに戻し、不一致が認証情報、ネットワーク、ストレージ、アプリケーションの準備状態、容量のどれに属するかを切り分けます。
例外または曖昧な結果の場合は、最後の安定した制限に戻し、ホストへの負荷を増やす前にヒープ、接続数、またはワーカーの同時実行数を減らします。低リスクの判別手順が再現可能で、より深いプラットフォームまたはハードウェアの変更が必要であることを証拠が示した場合にのみ、エスカレーションします。
元のホームサーバー負荷で永続性を検証する
ベースラインで使用したものと同じクライアントパス、ファイルサイズ、同時実行数、スリープまたは再起動イベント、競合するワークロードを再現します。少なくとも2サイクル実行し、キャッシュが温まった状態での成功、偶然うまくいった1回の再接続、または1回だけ正常だった起動を永続性と取り違えないようにします。
成功と封じ込めの両方を確認します。つまり、スワップスラッシング、OOMキル、ストレージレイテンシの悪化なしにピークワークロードが警告マージンを下回り、無関係なユーザー、サービス、共有、管理パスが元の動作を維持していることを確認します。変更が隣接するストレージ、ネットワーク、またはリカバリ境界に影響する場合は、関連するZimaSpaceワークフローを確認します。
受け入れシグナルが持続し、ロールバックが引き続き使用可能な場合にのみ、変更を完了します。カーネルがプロセスを強制終了する、JVMがネイティブメモリを確保できない、またはデータベースが有用なキャッシュを繰り返し追い出す場合は、自動化を停止し、ログと保存済み設定を保持して、さらに変更を積み重ねるのではなく、最後に検証された状態へ戻します。
クエリファンアウトに関するFAQ、完了判断、最終テスト
これらのクエリファンアウトに関する質問は、メイン設定が機能した後にユーザーがよく検索する次の判断を扱います。テストされていない修復パスを導入せずに、境界を補足します。
各回答は、測定された環境の条件が一致する場合にのみ適用します。バージョン、プロトコル、ファイルシステム、クライアント、信頼境界の違いによって、正しい分岐が変わることがあります。
回答はランブックとともに保管し、アップグレードやトポロジー変更後に更新します。書き込みアクセス、ネットワーク到達性、削除権限を拡大する例外には、改めてロールバックとリカバリのテストが必要です。
XmxはDockerのメモリ制限と同じにすべきですか?
いいえ。メタスペース、ダイレクトバッファ、スレッド、コードキャッシュ、ネイティブライブラリ、オペレーティングシステムのオーバーヘッドのための余裕を残してください。
データベースはバッファプールの外でもメモリを使用しますか?
はい。接続、作業領域、メンテナンス、拡張機能、ファイルシステムキャッシュによって、設定したプールを大幅に超えることがあります。
スワップは常に有害ですか?
常にではありません。ただし、対話的な作業中に継続的なスワップが発生する場合は、メモリ計画または同時実行数が不適切である強い兆候です。
結論: スワップスラッシング、OOMキル、ストレージレイテンシの悪化なしにピークワークロードが警告マージンを下回り、失敗分岐が理解され、文書化されたロールバックが変更対象のコンポーネントに依存しなくなった時点で、設定は完了です。
最終テスト手順: 保存済みのベースラインを復元し、承認済みの変更を一度適用して、元の本番に近い負荷を再現します。成功シグナルと封じ込め境界を確認した後、使い捨てデータでロールバックを実行します。5つすべての観測結果が一致した場合にのみ、変更を維持します。
サポートとヒント
もっと読む

ライブTV録画の容量・保存期間・クリーンアップガイド
実際の録音を測定し、ヘッドルームを確保し、経過時間と容量の制限を組み合わせ、ストレージが満杯になる前に最も古い対象プログラムが削除されることを確認する。

データベース復元後のホームメディアメタデータ復旧ワークフロー
復元した状態を保護し、メディアの識別情報とパスを確認してから、メタデータを広範囲に変更する前に、パイロットライブラリで不足しているアートワークや一致項目を修復します。

オーディオ、ビデオ、字幕のJellyfinクライアント互換性チェックリスト
代表的なファイルを一度に1つの変数だけテストし、すべてのクライアントについて、ダイレクトプレイ、リマックス、音声変換、動画トランスコード、または失敗を記録します。

