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 |
---|---|
| The number of entries currently in the cache. |
| The maximum size of the cache. |
| The percent of the maximum cache size now in use. If this ratio is close to 100, you probably want to increase the |
| The total number of attempts to retrieve items or query results from the cache. |
| The total number of times an access attempt successfully retrieved an item or query result from the cache. |
| The total number of times an access attempt did not find an item or query result from the cache. |
| The ratio of |
| The number of times the entire cache has been invalidated. |
| 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.