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 groupStatDescriptor locates and accesses particular statistics in the PMI tree. For example:
- 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"});
- 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});
- 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