You can view statistics on caches in a repository’s page in the Administrative Interface Component Browser, under the heading Cache usage statistics. For example, the Profile Repository’s page in the Component Browser can be found at:

http://hostname:port/nucleus/atg/userprofiling/ProfileAdapterRepository/

In this URL, hostname is the name of the machine running the application server and port is the port that your application server uses to listen for HTTP requests. To find the default port, see the ATG Installation and Configuration Guide.

Monitoring cache statistics during testing and after deployment can help you improve performance by setting cache sizes to appropriate levels. If you have a high quantity of misses and no hits, you are gaining no benefit from caching, and you can probably just turn it off, by setting the cache size to 0. If you have a mix of hits and misses, you might want to increase the cache size. If you have all hits and no misses, your cache size is big enough and perhaps too big. There is no harm in setting a cache to be too big unless it will fill up eventually and consume more memory than is necessary.

The cache usage statistics table presents the following statistics:

Property

Description

entryCount

The number of entries currently in the cache.

cacheSize

The maximum size of the cache.

usedRatio

The percent of the maximum cache size now in use. If this ratio is close to 100, you probably want to increase the cacheSize.

accessCount

The total number of attempts to retrieve items or query results from the cache.

hitCount

The total number of times an access attempt successfully retrieved an item or query result from the cache.

missCount

The total number of times an access attempt did not find an item or query result from the cache.

hitRatio

The ratio of hitRatio to accessCount.

cacheInvalidations

The number of times the entire cache has been invalidated.

entryInvalidations

The number of individual entries that have been invalidated.

You can also examine the contents of a cache using the <dump-caches> tag. See dump-caches Tag in the SQL Repository Definition Tag Reference section of this chapter.

 
loading table of contents...