Pega パッシベーション設計|格納先・タイムアウトの判断とヒープ枯渇の回避

同時ユーザー数が増えると JVM ヒープが逼迫し、GC 停止や OutOfMemory に至る。Pega のパッシベーションはアイドルなリクエスタ状態を退避してこれを緩和するが、格納先とタイムアウトを誤ると今度は I/O とアクティベーション遅延が新たなボトルネックになる。本記事では、格納先の選択・タイムアウトの決め方・クリップボードのスリム化という 3 つの判断軸を、よくある失敗パターンとともに整理する。

結論から:格納先は「他ノードで復元するか」、タイムアウトは「操作間隔と同時数」、前提はクリップボードのスリム化

Pega の本番環境で同時ユーザー数が増えていくと、必ず突き当たるのが JVM ヒープの逼迫です。放置すれば GC(ガベージコレクション)による停止時間が伸び、最悪 OutOfMemory でノードが落ちます。これを緩和する Pega の標準機構が パッシベーションです。

パッシベーションとは、一定時間アイドル(操作されていない)なリクエスタの状態、すなわちクリップボードを JVM ヒープから直列化して退避し、次にアクセスがあったときにアクティベーションで復元する仕組みです。目的はヒープ使用量の抑制と、同時ユーザー数のスケールです。

結論を先に言うと、設計判断は 3 つに整理できます。

① 格納先は「別ノードでセッションを復元する必要があるか」で決める(Pega の既定はデータベース格納で、これ自体が全ノードから読める共有格納)。② タイムアウトは「ユーザーの操作間隔」と「同時実行数」から決める。③ そもそもクリップボードをスリムに保つことが両者の前提になる。

パッシベーションはヒープ圧を下げますが、格納先とタイムアウトを誤ると、今度は退避・復元の I/O とアクティベーション遅延が新たなボトルネックになります。メモリ問題を I/O 問題にすり替えただけ、という事態を避けるのが設計の勘所です。

パッシベーション格納先の判断フロー 単一ノードならローカル格納で十分。マルチノードでも、ノード障害時にセッションを引き継ぐ必要がなければローカルでも可。引き継ぎが必要なら共有格納(Pega の既定である DB を含む)が前提になる、という判断フロー図。 格納先をどうする? ① マルチノード構成か? いいえ ローカルで十分 単一ノード=他ノード復元は不要 はい ② 障害時にセッションを引き継ぐ? いいえ ローカルでも可 スティッキーで固定・切断は許容 はい 共有格納が前提 既定は DB/共有ファイルシステム/カスタム 図:格納先は「他ノードでセッションを復元する必要があるか」で決まる
図:単一ノードならローカルで十分。マルチノードでも切断を許容できるならローカルで可。ノード障害をまたいでセッションを引き継ぎたいなら共有格納(Pega の既定である DB を含む)が前提になる。

パッシベーションとアクティベーションの基礎

Pega では、ログインしたユーザー(や実行主体)ごとに リクエスタ という単位でサーバー側の状態が管理され、その作業データは クリップボードというメモリ上のツリー構造に保持されます。クリップボードは JVM ヒープ上に載っているため、アクティブなユーザーが増えるほどヒープを消費します。

ここで、しばらく操作していないユーザーのクリップボードをヒープに載せ続けるのは無駄です。パッシベーションは、そのアイドルなクリップボードを直列化して外部(メモリ外)に退避し、ヒープを解放します。ユーザーが再び操作すると、退避した状態をアクティベーションで読み戻し、あたかも中断していなかったかのように作業を続行できます。

要するに、アクティブなユーザーだけをヒープに載せ、休んでいるユーザーは外に逃がす——これによって、物理メモリの制約を超えて同時接続ユーザー数をスケールさせるのがパッシベーションの狙いです。

なお、パッシベーションの効果が明確に出るのは、一般に同時接続リクエスタが数十規模(公式ドキュメントでは 50 程度以上)に達してからで、JVM メモリに十分な余裕がある小規模システムでは効果は小さいか、ほとんどありません。まず「本当にヒープが逼迫しているか」を計測で確認してからチューニングするのが順序です。

判断軸1:格納先をどう選ぶか

まず前提として、Pega の既定のパッシベーション格納先はデータベースです。公式ドキュメントでも「最も効率的で堅牢(most efficient and robust)」と位置づけられており、高可用性(HA)を有効化した環境でも既定でデータベース格納が使われます。データベースはすべてのノードから読めるため、既定のままで別ノードからのアクティベーション(=クロスノードのセッション復元)が成立します。つまり一般的なマルチノード本番構成では、「既定の DB 格納で引き継ぎ要件を満たしている」ことが多い、というのが出発点です。

そのうえで、標準(OOTB)で選べる格納方式は公式には次の 3 つに整理されます —— データベース(既定)/ファイルシステム/カスタム。ファイルシステム格納は退避データを PassivationData ディレクトリ(テンポラリ領域配下)に Java 直列化ファイルとして書き出す方式で、これを各ノードのローカルディスクに置くか、全ノードから見える共有ストレージ(NFS・共有ディスク等)に置くかで挙動が大きく変わります。独自の分散ストレージ等へ退避したい場合は「カスタム」方式(Java クラスを実装)になります。

判断の核心は、冒頭の図のとおり「別のノードでセッションを復元する必要があるか」の一点です。マルチノード構成では、あるノードで退避したセッションを別のノードがアクティベーションで復元できなければ、ノード障害時にユーザーの作業が失われます。他ノードから読めるようにするには、全ノードから見える共有格納(既定の DB か、共有ストレージ上のファイルシステム)である必要があります。各ノードのローカルファイルシステムに退避すると、そのノードが落ちた瞬間に退避データも道連れになり、引き継ぎはできません。

格納先別ノードでの引き継ぎ位置づけ・特性向いている状況
データベース(既定)可(全ノードから読める)Pega の既定。公式に「最も効率的で堅牢」とされ、HA 有効時も既定。追加基盤が不要大半の本番(マルチノード HA)。まず第一候補
ファイルシステム(共有:NFS・共有ディスク)可PassivationData を全ノードから見える共有ストレージに置く。共有ストレージの帯域・可用性に律速高信頼の共有 FS が既にあり、退避 I/O を DB 負荷から切り離したい
ファイルシステム(各ノードのローカル)不可(自ノードでのみ復元)構成は単純だが、そのノードが落ちると退避データも失われる単一ノード、またはスティッキー固定で切断(再ログイン)を許容できる場合に限る
カスタム実装依存Java クラスを実装し独自バックエンド(分散ストレージ等)へ退避。クラウド/大規模向けだが運用コスト増既定の DB/FS では要件を満たせない特殊要件

共有格納(DB/共有 FS)は可用性を確保する代わりに、DB や共有ストレージへの I/O・運用コストを払います。可用性とコストのトレードオフだと理解しておくことが重要です。既定が DB である以上、「ローカルファイルシステムのほうが速く単純だから」と安易にローカルへ切り替えると、マルチノードでの引き継ぎを失う点には注意してください。

注意: 具体的な格納方式は prconfig 設定 initialization/persistrequestor/storage(値: database / filesystem / custom)などで制御します。ただし既定値・利用可否・分散キャッシュの可否は、Pega のバージョンとデプロイ形態(オンプレミス/各種クラウド)で異なります。設定キーや初期値も版によって変わるため、対象環境の版の公式ドキュメントで必ず確認してください。本記事は版に依存しない設計の考え方を示すものです。

判断軸2:タイムアウトをどう決めるか

パッシベーションのアイドルタイムアウト(何秒アイドルなら退避するか)は、ヒープと I/O のトレードオフそのものです。

  • 短くする → ヒープは早く空くが、退避・復元が頻発し、I/O 負荷とアクティベーション遅延が増える
  • 長くする → 退避が減って応答は軽いが、アイドルなユーザーがヒープに居座り、メモリ圧が増える
アイドルタイムアウトヒープI/O・遅延向いている状況
短い早く解放(節約に有利)退避/復元が頻発、体感遅延が出やすい同時ユーザーが極端に多い、1 操作が短時間で終わる
長い圧が増える退避が減り応答は軽い操作間隔が長い業務、同時数が抑えられている

適正値は、ユーザーの実際の操作間隔と同時実行数から決めます。たとえば、数分おきに 1 アクションするような業務なら、その間隔よりわずかに長いタイムアウトにすれば、「席を外した本当のアイドル」だけを退避でき、操作の合間の頻繁な退避・復元を避けられます。逆に、席を立ったまま戻らないユーザーが多い環境では、タイムアウトを短めにしてヒープを積極的に空けるほうが全体の安定に効きます。机上の数値ではなく、本番のアクセスパターンを計測して決めるべき項目です。

補足として、Pega のパッシベーションは単一のしきい値ではなく、粒度の異なる複数のレベルで働きます。常駐するパッシベーションデーモンが定期的(一般に毎分)にクリップボードを走査し、アイドルな個々のページ/スレッド/リクエスタ全体を、それぞれのしきい値で退避します。現行の Pega Platform の既定値は、ページが約 15 分、スレッドが約 30 分、リクエスタ全体が約 60 分アイドルで退避、というものです(版により異なるため対象環境の公式ドキュメントで確認してください)。とくにページパッシベーションはリクエスタを止めずに、使われていないページだけを退避でき、そのページが再び必要になった時点で個別にアクティベーションされます。したがって実務では、リクエスタ全体のタイムアウトだけでなく、この粒度ごとのしきい値も含めて「何を・どのくらいで逃がすか」を設計します。

判断軸3:クリップボードのスリム化(すべての前提)

格納先とタイムアウトを正しく選んでも、そもそも退避するクリップボードが肥大化していれば、退避 I/O もアクティベーション遅延も悪化します。1 セッションあたりのクリップボードが大きいほど、直列化するデータ量が増え、復元も遅くなるからです。パッシベーション設計の前提として、クリップボードのスコープ管理とスリム化が欠かせません。公式ドキュメントでも、長時間使われないページはそもそも設計・実装の不備を示すことが多く、性能を損なうため、不要なページを特定して削減することが推奨されています。

肥大化の典型的な原因は次のとおりです。

  • 不要ページの残留 — 使い終わったページや一時作業ページがクリップボードに残り続ける
  • 大きな埋め込みリスト — 数百〜数千行のリストをまるごとクリップボードに載せる
  • データページの常駐 — スコープの広いデータページに大量データを保持し続ける

対策は、クリップボードに載せるデータのスコープを必要最小限に絞ること、大量データはページング/サーバー側処理に寄せてクリップボードに全件展開しないこと、そして使い終わったページを明示的に片付けることです。**クリップボードが軽ければ、パッシベーションは軽く速く回ります。**これが 3 つの軸のうちで最も効き、かつ最も見落とされやすいポイントです。

セッションアフィニティ(スティッキー)との相互作用

マルチノード構成では、ロードバランサの **セッションアフィニティ(スティッキーセッション)**の設定がパッシベーション設計と密接に絡みます。

アフィニティが効いている間は、同じユーザーのリクエストは常に同じノードに振られるため、そのノードで(ローカル退避であっても)復元できます。しかし、アフィニティが崩れる——ノード障害、スケールイン/アウト、ロードバランサの再分配などが起きると、別ノードでのアクティベーションが必要になります。このとき、退避先がローカルだと復元できず、セッションが失われます。既定の DB 格納(や共有ストレージ上のファイルシステム)であれば、別ノードからでも退避データを読めるため、この局面でも復元できます。

したがって、「ノード障害をまたいでもセッションを引き継ぎたい」なら、共有格納が前提条件になります。「スティッキーが効いているから大丈夫」という前提は、アフィニティが崩れる瞬間に破綻します。可用性要件(障害時にユーザー作業を守るか、再ログインを許容するか)を先に決め、そこから格納先を逆算するのが正しい順序です。

よくある失敗

  • マルチノードなのにローカルのファイルシステム格納にしている — 既定は DB 格納なので通常は起きないが、旧構成の踏襲やチューニング目的でローカル FS に切り替えたまま放置すると発生する。平常時は問題なく動くため見過ごされがちで、ノード障害やスケールイン時に初めて「作業中の画面が消える」形で顕在化する。可用性要件を満たすなら共有格納(既定の DB を含む)に戻す。
  • タイムアウトを勘で設定する — 本番の操作間隔を計測せずに設定し、頻繁な退避・復元でかえって遅くなる、あるいはヒープが空かない。アクセスパターンの計測が先。
  • クリップボード肥大化を放置したままチューニングする — 格納先やタイムアウトばかり触り、肝心のクリップボードが重いままだと、退避 I/O とアクティベーション遅延は改善しない。まずスリム化。
  • メモリ問題を I/O 問題に付け替えて満足する — タイムアウトを詰めてヒープは空いたが、退避・復元が急増して I/O とレスポンスが悪化。3 軸をセットで見ないと、ボトルネックが移動するだけになる。

まとめ

  • パッシベーションは、アイドルなリクエスタのクリップボードをヒープから退避し、アクティベーションで復元する仕組み。目的はヒープ節約と同時ユーザー数のスケール。効果が出るのは一般に同時接続リクエスタが数十規模(公式には 50 程度以上)から。
  • 格納先は「別ノードでセッションを復元する必要があるか」で決める。Pega の既定は DB 格納で、これ自体が全ノードから読める共有格納なので、多くのマルチノード本番はそのままで引き継ぎ要件を満たす。ローカルのファイルシステムに切り替えるのは単一ノード等に限る。可用性とコストのトレードオフ。
  • タイムアウトは、勘ではなく本番の操作間隔と同時実行数から決める。短ければ I/O 増、長ければメモリ圧増。パッシベーションはページ/スレッド/リクエスタの粒度ごとに働き、既定はおおむねページ 15 分・スレッド 30 分・リクエスタ 60 分(版依存)。
  • クリップボードのスリム化が両者の前提。退避対象が軽ければ、I/O もアクティベーション遅延も小さくなる。
  • 3 軸はセットで見る。1 つだけ触ると、ボトルネックが移動するだけになる。

パッシベーション設計は、同時ユーザー数が本番規模に達したときに初めて効いてくる「地味だが致命的」な領域です。設計・負荷試験の段階でここを押さえておくことが、リリース後のヒープ枯渇や応答遅延を防ぎます。なお、設定キーや既定値、分散キャッシュの可否は版・デプロイ形態で異なるため、必ず対象環境の版で確認してください。

関連リンク

このテーマの記事をまとめて読む: Pega の性能とレポート設計 用語は Pega 用語集 で引けます

関連記事

Pega Process AI の予測をケースに組み込む判断|適応モデルと決定ルールの使い分け

ケースの振り分けや優先度づけを「予測に任せるか、ルールで決め切るか」は、多くの実装で迷う分岐点です。本記事では Pega Process AI の予測をどこに、どう組み込むべきかを、モデル選定・フォールバック設計・運用監視の観点から整理し、実装者が具体的に判断できる形にまとめます。

記事を読む

Pega 日時・タイムゾーン設計|DateTime と Date の使い分けと UTC 保存の落とし穴

「登録日が1日ずれる」「バッチの集計時刻が合わない」——多言語・多地域展開の Pega アプリで LSA が必ず直面するのが日時とタイムゾーンの設計だ。DateTime を UTC で保存し表示で現地時刻へ変換するモデルを理解せず、暦上の日付まで DateTime にしてしまうと、タイムゾーン変換で日付が前後する。プロパティ型の選択基準から整理する。

記事を読む

Pega ケース移行の設計判断|進行中ケースを移すか切替後に新規作成か

「旧システムの進行中案件をPegaへそのまま移せますか?」— レガシー移行で必ず出るこの問いに、LSAは安易に頷けない。過去フローの完全再現はほぼ不可能で、現在ステージと業務データの再現に絞るのが定石だ。本記事はオープンケース移行と切替後新規作成の分岐、SLA・アサインメント・監査履歴の扱い、段階移行とビッグバンの判断を、失敗例とともに整理する。

記事を読む

設計標準と設計レビューのご相談

判断の理由と適用範囲まで書いた設計標準をもとに、設計レビューと内製化を支援しています。