Dynamic cache PMI counter definitions

The dynamic cache statistics interface is defined as WSDynamicCacheStats under the com\ibm\websphere\pmi\stat package. Dynamic cache statistics are structured as follows in the Performance Monitoring Infrastructure (PMI) tree 

__Dynamic Caching+
  |
  |__<Servlet: instance_1>
    |__Templates+
      |__<template_1>
      |__<template_2>
    |__Disk+
      |__<Disk Offload Enabled>
  |
  |__<Object: instance_2>
    |__Object Cache+
      |__<Counters>
+ indicates logical group

StatDescriptor locates and accesses particular statistics in the PMI tree. For example:

  1. StatDescriptor to represent statistics for cache servlet: instance_1 templates group template_1: new StatDescriptor (new String[] {WSDynamicCacheStats.NAME, "Servlet: instance1", WSDynamicCacheStats.TEMPLATE_GROUP, "template_1"});

  2. StatDescriptor to represent statistics for cache servlet: instance_1 disk group Disk Offload Enabled: new StatDescriptor (new String[] {WSDynamicCacheStats.NAME, "Servlet: instance_1", WSDynamicCacheStats.DISK_GROUP, WSDynamicCacheStats.DISK_OFFLOAD_ENABLED});

  3. StatDescriptor to represent statistics for cache object: instance2 object cache group Counters: new StatDescriptor (new String[] {WSDynamicCacheStats.NAME, "Object: instance_2", WSDynamicCacheStats.OBJECT_GROUP, WSDynamicCacheStats.OBJECT_COUNTERS});

Important: Cache instance names are prepended with cache type ("Servlet: " or "Object: ").

 

Counter definitions for Servlet Cache

Name of PMI statistics Path Description Version
WSDynamicCacheStats.MaxInMemoryCacheEntryCount WSDynamicCacheStats.NAME - “Servlet: instance_1“ The maximum number of in-memory cache entries. 5.0 and later
WSDynamicCacheStats.InMemoryCacheEntryCount WSDynamicCacheStats.NAME - “Servlet: instance_1“ The current number of in-memory cache entries 5.0 and later
WSDynamicCacheStats.HitsInMemoryCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of requests for cacheable objects that are served from memory. 5.0 and later
WSDynamicCacheStats.HitsOnDiskCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of requests for cacheable objects that are served from disk. 5.0 and later
WSDynamicCacheStats.ExplicitInvalidationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of explicit invalidations. 5.0 and later
WSDynamicCacheStats.LruInvalidationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1 The number of cache entries that are removed from memory by a Least Recently Used (LRU) algorithm. instance. 5.0 and later
WSDynamicCacheStats.TimeoutInvalidationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of cache entries that are removed from memory and disk because their timeout has expired. 5.0 and later
WSDynamicCacheStats.InMemoryAndDiskCacheEntryCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The current number of used cache entries in memory and disk. 5.0 and later
WSDynamicCacheStats.RemoteHitCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of requests for cacheable objects that are served from other Java virtual machines within the replication domain. 5.0 and later
WSDynamicCacheStats.MissCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of requests for cacheable objects that were not found in the cache. 5.0 and later
WSDynamicCacheStats.ClientRequestCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of requests for cacheable objects that are generated by applications running on this application server. 5.0 and later
WSDynamicCacheStats.DistributedRequestCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of requests for cacheable objects that are generated by cooperating caches in this replication domain. 5.0 and later
WSDynamicCacheStats.ExplicitMemoryInvalidationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of explicit invalidations resulting in the removal of an entry from memory. 5.0 and later
WSDynamicCacheStats.ExplicitDiskInvalidationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of explicit invalidations resulting in the removal of an entry from disk. 5.0 and later
WSDynamicCacheStats.LocalExplicitInvalidationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of explicit invalidations generated locally, either programmatically or by a cache policy. 5.0 and later
WSDynamicCacheStats.RemoteExplicitInvalidationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of explicit invalidations received from a cooperating Java virtual machine in this replication domain. 5.0 and later
WSDynamicCacheStats.RemoteCreationCount WSDynamicCacheStats.NAME - “Servlet: cache_instance_1“ - WSDynamicCacheStats.TEMPLATE_GROUP -“Template_1” The number of cache entries that are received from cooperating dynamic caches. 5.0 and later

 

Counter definitions for Object Cache

Name of PMI Statistics Path Description Version
WSDynamicCacheStats.MaxInMemoryCacheEntryCount WSDynamicCacheStats.NAME - “Object: instance_2“ The maximum number of in-memory cache entries. 5.0 and later
WSDynamicCacheStats.InMemoryCacheEntryCount WSDynamicCacheStats.NAME - “Object: instance_2“ The current number of in-memory cache entries 5.0 and later
WSDynamicCacheStats.HitsInMemoryCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of requests for cacheable objects that are served from memory. 5.0 and later
WSDynamicCacheStats.HitsOnDiskCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of requests for cacheable objects that are served from disk. 5.0 and later
WSDynamicCacheStats.ExplicitInvalidationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of explicit invalidations. 5.0 and later
WSDynamicCacheStats.LruInvalidationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of cache entries that are removed from memory by a Least Recently Used (LRU) algorithm. instance. 5.0 and later
WSDynamicCacheStats.TimeoutInvalidationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of cache entries that are removed from memory and disk because their timeout has expired. 5.0 and later
WSDynamicCacheStats.InMemoryAndDiskCacheEntryCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The current number of used cache entries in memory and disk. 5.0 and later
WSDynamicCacheStats.RemoteHitCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of requests for cacheable objects that are served from other Java virtual machines within the replication domain. 5.0 and later
WSDynamicCacheStats.MissCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of requests for cacheable objects that were not found in the cache. 5.0 and later
WSDynamicCacheStats.ClientRequestCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of requests for cacheable objects that are generated by applications running on this application server. 5.0 and later
WSDynamicCacheStats.DistributedRequestCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of requests for cacheable objects that are generated by cooperating caches in this replication domain. 5.0 and later
WSDynamicCacheStats.ExplicitMemoryInvalidationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of explicit invalidations resulting in the removal of an entry from memory. 5.0 and later
WSDynamicCacheStats.ExplicitDiskInvalidationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of explicit invalidations resulting in the removal of an entry from disk. 5.0 and later
WSDynamicCacheStats.LocalExplicitInvalidationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of explicit invalidations generated locally, either programmatically or by a cache policy. 5.0 and later
WSDynamicCacheStats.RemoteExplicitInvalidationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of explicit invalidations received from a cooperating Java virtual machine in this replication domain. 5.0 and later
WSDynamicCacheStats.RemoteCreationCount WSDynamicCacheStats.NAME - “Object: cache_instance_2“ - WSDynamicCacheStats.OBJECT_GROUP - WSDynamicCacheStats OBJECT_COUNTERS The number of cache entries that are received from cooperating dynamic caches. 5.0 and later

Related concepts
Custom PMI API Related tasks
Developing your own monitoring applications Related reference
PMI data organization