intra-mart Accel Platform セットアップガイド 第45版 2024-01-31

5.3.4.9. ポータルの認可サブジェクト情報キャッシュ

intra-mart Accel Platform のポータルの認可サブジェクト情報のキャッシュについて設定します。

コラム

ポータルの認可サブジェクト情報キャッシュ設定は ポータル機能 に含まれています。

  1. 「ProjectNavigator」内の <conf/im-ehcache-config/im_portal-subjecttype.xml> ファイルをダブルクリックで開き、「ソース」タブを選択してください。
  2. <im-ehcache-config>/<cache> の内容を運用規模に応じて変更します。
<cache
  name="IM_PORTAL-SUBJECTTYPE"
  enable="true"
  max-elements-on-memory="200"
  time-to-live-seconds="3600"
  time-to-idle-seconds="1800"
/>

コラム

「max-bytes-memory」及び、「max-bytes-disk」属性が設定されている場合、Cacheにオブジェクトを登録する際に、そのオブジェクトのサイズの計算処理が行われます。
この際、登録するオブジェクトが、別のオブジェクトの参照を大量に持つ場合、計算処理に時間がかかりパフォーマンスの低下の原因となる可能性があります。
登録するオブジェクトが1000以上の参照を持つ場合、下記のようなメッセージがログに出力されます。
The configured limit of 1,000 object references was reached while attempting to calculate the size of the object graph.
Severe performance degradation could occur if the sizing operation continues.
This can be avoided by setting the CacheManger or Cache <sizeOfPolicy> elements maxDepthExceededBehavior to "abort" or adding stop points with @IgnoreSizeOf annotations.
If performance degradation is NOT an issue at the configured limit, raise the limit value using the CacheManager or Cache <sizeOfPolicy> elements maxDepth attribute.
For more information, see the Ehcache configuration documentation.
このログが出力される場合は、キャッシュに格納するオブジェクトの構成を見直すか、「max-bytes-memory」または、「max-bytes-disk」の代わりに、「max-elements-on-memory」または「max-elements-on-disk」の利用を検討して下さい。

5.3.4.9.1. キャッシュするオブジェクトの単位

ポータルの認可サブジェクト情報は、HTTPセッション単位でキャッシュされます。
そのため、キャッシュするオブジェクト数は、同時アクセスの最大HTTPセッション数によって見積もります。

5.3.4.9.2. キャッシュサイズの計算式

キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。

キャッシュサイズ(オブジェクトの数) = (1)

(1) ... HTTPセッション数

intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。

同時アクセスの最大HTTPセッション数を200と仮定しています。