Chapter 23 Configuring Query Agents (Cache OM) : Configuring Query Agents—Engine Properties for Performance

Configuring Query Agents—Engine Properties for Performance
Query agents have only a few agent-level properties. (Query agents are stateless and are not run in load-balanced or fault-tolerant groups and do not require properties relating to those features.)
This section builds on cluster-level configuration settings and assumes they are in place. See the following chapters for those settings:
Query Agent Properties
Query agent properties are used to configure the query agent local cache:
be.agent.query.localcache.maxelements
be.agent.query.localcache.evictseconds
be.agent.query.localcache.prefetchaggressive
The query agent’s local cache stores cache data locally for efficient reuse. The local cache listens to and synchronizes the locally stored entity instances with those in the main cache, so that the local cache stays up-to-date.
The prefetch feature improves performance, but CPU and memory usage increases as a result of the aggressive prefetching. You may have to try different values till you find the optimal settings for your environment.
If the default values provide good performance, you do not have to add these properties when configuring a query agent.
Specifies the maximum number of entities that can be stored in the query-agent's local cache. When the threshold is reached, oldest entities are removed first.
Specifies an age limit on the cached entities in seconds. After this period, they are removed from the local cache.
Note  Age resets each time an entity is accessed by the query engine.
be.agent.query.localcache.prefetchaggressive