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

5.3.4.5. 認可IPv4サブジェクト設定キャッシュ

intra-mart Accel Platform の認可設定のIPv4サブジェクトに関するキャッシュについて設定します。

コラム

認可IPv4サブジェクト設定キャッシュ設定は テナント管理機能 に含まれています。

  1. 「ProjectNavigator」内の <conf/im-ehcache-config/authz-subjecttype-ipv4.xml> ファイルをダブルクリックで開き、「ソース」タブを選択してください。
  2. <im-ehcache-config>/<cache> の内容を運用規模に応じて変更します。
<cache
  name="IM_TENANT-AUTHZ_SUBJECTTYPE_IPV4"
  enable="true"
  max-bytes-memory="64k"
  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.5.1. キャッシュするオブジェクトの単位

認可IPv4サブジェクト設定は、テナント単位でキャッシュされます。
そのため、キャッシュするオブジェクト数は1つです。

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

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

キャッシュサイズ = ( (1) + (2) ) × (3)

(1) … IPv4 に関するサブジェクトID のバイト数 (64byte)
(2) … アドレスパターン文字列 (平均 100byte)
(3) … 登録されている IPv4 に関するサブジェクトの数

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

(64 + 100) × 400 = 65600
⇒ 64KB

コラム

上記を算出するために利用している各要素の想定数については以下の通りです
  • 登録されている IPv4 に関するサブジェクトの数 : 400