Displaying cache information

Use this task to monitor the activity of the dynamic cache service.

Overview

The dynamic cache monitor is an installable Web application that displays simple cache statistics, cache entries, and cache policy information for servlet cache instances.

Procedure

1. Use the administrative console to install the cache monitor application from the app_server_root/installableApps directory. The name of the application is CacheMonitor.ear. For more information about installing applications, see Installing application files with the console. Install the cache monitor onto the application server that you want to monitor.

2. Configure the Web container transport chain and host alias for the server with cache monitor installed.

   1. Add a host alias for the port your server is using. Click Environment > Virtual hosts > host_type > Host aliases and create a new Host name and Port to add to the list.

   2. You can then access the cache monitor using http://your_host_name:your_port_number/cachemonitor.

   You can find the port number in the SystemOut.log file. Look for message TCPC0001I or SRVE0171I.

3. Access the cache monitor using a Web browser and the URL http://your host_name:your port_number/cachemonitor, where your port_number is the port associated with the host on which you installed the cache monitor application.

4. Verify the list of cache instances that are shown. For each cache instance, you can perform the following actions:

   You must select the servlet cache instance that you want to monitor. If you do not use servlet cache instances by using <cache-instance> tags in your cachespec.xml file, all the content is in the baseCache instance.

   • View the Statistics page and verify the cache configuration and cache data. Click Reset Statistics to reset the counters.

   • View the Cache Policies page to see which cache policies are currently loaded in the dynamic cache. Click on a template to view the cache ID rules for the template.

   • View the Cache Contents page to examine the contents that are currently cached in memory.

   • View the Edge Statistics page to view data about the current ESI processors configured for caching. Click Refresh Statistics to see the latest statistics or content from the ESI processors. Click Reset Statistics to reset the counters.

   • View the Disk Offload page to view the disk configuration, statistics, and the content that is currently off-loaded from memory to disk.

   When you are viewing contents on memory or disk, click on a template to view all entries for that template, click on a dependency ID to view all entries for the ID, or click on the cache ID to view all the data that is cached for that entry.

5. Use the cache monitor to perform basic operations on data in a cache instance.

   Remove an entry from cache

   Click Invalidate when viewing a cache entry.

   Remove all entries for a certain dependency ID

   Click Invalidate when viewing entries for a dependency ID.

   Remove all entries for a certain template

   Click Invalidate when viewing entries for a template.

   Move an entry to the front of the Least Recently Used queue to avoid eviction

   Click Refresh when viewing a cache entry.

   Move an entry from disk to cache

   Click Send to Memory when viewing a cache entry on disk.

   Clear the entire contents of the cache

   Click Clear Cache while viewing statistics or contents.

   Clear the contents on the ESI processors

   Click Clear Cache while viewing ESI statistics or contents.

   Clear the contents of the disk cache

   Click Clear Disk while viewing disk contents.

Related tasks