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

5.3.4.8. 個人設定メニューキャッシュ

intra-mart Accel Platform の個人設定メニューのキャッシュについて設定します。

コラム

個人設定メニューキャッシュ設定は テナント管理機能 に含まれています。

  1. 「ProjectNavigator」内の <conf/im-ehcache-config/menu-personal-settings-item.xml> ファイルをダブルクリックで開き、「ソース」タブを選択してください。
  2. <im-ehcache-config>/<cache> の内容を運用規模に応じて変更します。
<cache
  name="IM_TENANT-MENU_PERSONAL_SETTINGS_ITEM"
  enable="true"
  max-bytes-memory="80M"
  time-to-live-seconds="259200"
  time-to-idle-seconds="259200"
/>

コラム

「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.8.1. キャッシュするオブジェクトの単位

個人設定メニューは、ユーザ単位でキャッシュされます。
そのため、キャッシュするオブジェクト数は、利用ユーザ数によって見積もります。

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

キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。
キャッシュサイズ = ((1) + (2) + (3) + (4) × (5)) × (6)

(1) ... キャッシュの管理情報(平均 200byte)
(2) ... キャッシュのキー情報(平均 1000byte)
(3) ... 個人設定のメニュー情報(平均 200byte)
(4) ... 個人設定配下のメニュー情報(平均 2000byte)
(4) = (4a) + (4b)
(4a) ... メニュー基本情報
(4b) ... メニュー多言語情報
(5) ... 個人設定配下のメニュー数
(6) ... 利用ユーザ数
intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。
(200 + 1000 + 200 + 2000 × 20) × 2000 = 82800000
⇒ 80MB

コラム

上記を算出するために利用している各要素の想定数については以下の通りです
  • 個人設定配下のメニュー数 : 20
  • 利用ユーザ数 : 2000