net.sf.ehcache.management.sampled
Class SampledCache

java.lang.Object
  javax.management.StandardMBean
      net.sf.ehcache.hibernate.management.impl.BaseEmitterBean
          net.sf.ehcache.management.sampled.SampledCache

All Implemented Interfaces:

PropertyChangeListener, EventListener, DynamicMBean, MBeanRegistration, NotificationBroadcaster, NotificationEmitter, CacheSampler, SampledCacheMBean, LiveCacheStatistics, SampledCacheStatistics

public class SampledCache
extends BaseEmitterBean
implements SampledCacheMBean, PropertyChangeListener

An implementation of SampledCacheMBean

Author:

Abhishek Sanoujam, byoukste

Field Summary

Fields inherited from class net.sf.ehcache.hibernate.management.impl.BaseEmitterBean

emitter, sequenceNumber

Fields inherited from interface net.sf.ehcache.management.sampled.SampledCacheMBean

CACHE_CHANGED, CACHE_CLEARED, CACHE_ENABLED, CACHE_FLUSHED, CACHE_STATISTICS_ENABLED, CACHE_STATISTICS_RESET

Constructor Summary

SampledCache(Ehcache cache)
Constructor accepting the backing Ehcache

Method Summary

void	clearStatistics() Clear both sampled and cumulative statistics
void	disableSampledStatistics() Disables statistics collection
void	disableStatistics() Disables statistics collection.
protected void	doDispose() Dispose callback of subclasses
void	enableSampledStatistics() Enables statistics collection.
void	enableStatistics() Enables statistics collection
void	flush() Flushes all cache items from memory to the disk store, and from the DiskStore to disk.
float	getAverageGetTimeMillis() Average time in milliseconds taken to get an element from the cache.
long	getAverageGetTimeMostRecentSample() Get most recent value for average time taken for get() operation in the cache
long	getAverageGetTimeNanos() Average time in nanoseconds taken to get an element from the cache.
long	getAverageGetTimeNanosMostRecentSample() Get most recent value for average time taken for get() operation in the cache
long	getAverageSearchTime() Get the average search execution time for searches finishing within the last sample period
Map<String,Object>	getCacheAttributes() getCacheAttributes
long	getCacheAverageGetTime()
long	getCacheAverageSearchTime()
long	getCacheElementEvictedMostRecentSample() Get most recent value element evicted from cache
long	getCacheElementExpiredMostRecentSample() Get most recent value element expired from cache
long	getCacheElementPutMostRecentSample() Get most recent value element puts in the cache
long	getCacheElementRemovedMostRecentSample() Get most recent value element removed from cache
long	getCacheElementUpdatedMostRecentSample() Get most recent value element updates , i.e.
long	getCacheEvictionRate()
long	getCacheExpirationRate()
long	getCacheHitCount() The number of times a requested item was found in the cache.
long	getCacheHitInMemoryMostRecentSample() Get most recent value for in-memory cache hit
long	getCacheHitMostRecentSample() Get most recent value for cache hit
long	getCacheHitOffHeapMostRecentSample() Get most recent value for off-heap cache hit
long	getCacheHitOnDiskMostRecentSample() Get most recent value for on-disk cache hit
long	getCacheHitRate()
int	getCacheHitRatio() The ratio of hits to accesses (hits + misses).
int	getCacheHitRatioMostRecentSample() Get most recent value for cache hit ratio
long	getCacheInMemoryHitRate()
long	getCacheInMemoryMissRate()
long	getCacheMissCount() Number of times a requested element was not found in the cache.
long	getCacheMissCountExpired()
long	getCacheMissExpiredMostRecentSample() Get most recent value for cache miss as result of the element getting expired
long	getCacheMissInMemoryMostRecentSample() Get most recent value for in-memory cache miss
long	getCacheMissMostRecentSample() Get most recent value for cache miss
long	getCacheMissNotFoundMostRecentSample() Get most recent value for cache miss as result of the element not found in cache
long	getCacheMissOffHeapMostRecentSample() Get most recent value for off-heap cache miss
long	getCacheMissOnDiskMostRecentSample() Get most recent value for on-disk cache miss
long	getCacheMissRate()
String	getCacheName()
long	getCacheOffHeapHitRate()
long	getCacheOffHeapMissRate()
long	getCacheOnDiskHitRate()
long	getCacheOnDiskMissRate()
long	getCachePutRate()
long	getCacheRemoveRate()
long	getCacheSearchRate()
long	getCacheUpdateRate()
long	getCacheXaCommitsMostRecentSample() Get most recent value of XA commits
long	getCacheXaRollbacksMostRecentSample() Get most recent value of XA rollbacks
long	getDiskExpiryThreadIntervalSeconds() Configuration property accessor
long	getEvictedCount() Number of elements evicted from the cache
long	getExpiredCount() Number of elements expired since creation or last clear
boolean	getHasWriteBehindWriter() Is there a registered Write-behind CacheWriter
long	getInMemoryHitCount() Number of times a requested item was found in the Memory Store.
long	getInMemoryMissCount() Number of times a requested item was not found in the Memory Store.
long	getInMemorySize() Deprecated. use getLocalHeapSize()
long	getLocalDiskSize() Number of entries in the DiskStore
long	getLocalDiskSizeInBytes() Number of of bytes used by entries in the DiskStore
long	getLocalHeapSize() Number of entries in the MemoryStore
long	getLocalHeapSizeInBytes() Number of of bytes used by entries in the MemoryStore
long	getLocalOffHeapSize() Number of entries in the off-heap store
long	getLocalOffHeapSizeInBytes() Number of of bytes used by entries in the off-heap store
long	getMaxBytesLocalDisk() Configuration property accessor
String	getMaxBytesLocalDiskAsString() Configuration property accessor
long	getMaxBytesLocalHeap() Configuration property accessor
String	getMaxBytesLocalHeapAsString() Configuration property accessor
long	getMaxBytesLocalOffHeap() Configuration property accessor
String	getMaxBytesLocalOffHeapAsString() Configuration property accessor
int	getMaxElementsInMemory() Configuration property accessor
int	getMaxElementsOnDisk() Configuration property accessor
long	getMaxEntriesLocalDisk() Configuration property accessor
long	getMaxEntriesLocalHeap() Configuration property accessor
long	getMaxGetTimeMillis() Return maximum time taken for a get operation in the cache in milliseconds
long	getMaxGetTimeNanos() Return maximum time taken for a get operation in the cache in milliseconds
String	getMemoryStoreEvictionPolicy() Configuration property accessor
long	getMinGetTimeMillis() Return minimum time taken for a get operation in the cache in milliseconds
long	getMinGetTimeNanos() Return minimum time taken for a get operation in the cache in nanoseconds
MBeanNotificationInfo[]	getNotificationInfo()
long	getOffHeapHitCount() Number of times a requested item was found in the off-heap store.
long	getOffHeapMissCount() Number of times a requested item was not found in the off-heap store.
long	getOffHeapSize() Deprecated. use getLocalOffHeapSize()
long	getOnDiskHitCount() Number of times a requested item was found in the Disk Store.
long	getOnDiskMissCount() Number of times a requested item was not found in the Disk Store.
long	getOnDiskSize() Deprecated. use getLocalDiskSize()
String	getPinnedToStore() Configuration property accessor
long	getPutCount() Number of puts that has happened in the cache
long	getRemovedCount() Number of elements removed since creation or last clear
boolean	getSearchable() Is the cache configured for search
long	getSearchesPerSecond() Get the number of searches that have finished execution in the last second
long	getSize() Size of the cache based on current accuracy settings.
int	getStatisticsAccuracy() Accurately measuring statistics can be expensive.
String	getStatisticsAccuracyDescription() Accurately measuring statistics can be expensive.
String	getStatus() Gets the status attribute of the Cache.
String	getTerracottaConsistency() Returns a textual description of a Terracotta-clustered cache's consistency mode.
long	getTimeToIdleSeconds() Configuration property accessor
long	getTimeToLiveSeconds() Configuration property accessor
boolean	getTransactional() Is the cache a transactional one
long	getTransactionCommitRate()
long	getTransactionRollbackRate()
long	getUpdateCount() Number of updates that as happened in the cache
int	getWriterConcurrency() Returns the number of configured write-behind queues/threads.
int	getWriterMaxQueueSize() Returns the maximum size of any write-behind queues.
long	getWriterQueueLength() Returns the total length of all write-behind queues for this cache
long	getXaCommitCount() Return the Cache's XAResource commit calls count
long	getXaRecoveredCount() Return the Cache's XAResource recovered XIDs count
long	getXaRollbackCount() Return the Cache's XAResource rollback calls count
boolean	isClusterBulkLoadEnabled() Is the cache in bulk-load mode cluster-wide?
boolean	isClusterCoherent() Deprecated.
boolean	isDiskPersistent() Configuration property accessor
boolean	isEnabled() Is the cache enabled?
boolean	isEternal() Configuration property accessor
boolean	isLoggingEnabled() Configuration property accessor
boolean	isNodeBulkLoadEnabled() Is the cache in bulk-load mode locally?
boolean	isNodeCoherent() Deprecated.
boolean	isOverflowToDisk() Configuration property accessor
boolean	isPinned() Configuration property accessor
boolean	isSampledStatisticsEnabled() Returns true if statistics collection is enabled for cache, otherwise false
boolean	isStatisticsEnabled() Returns true if statistics is enabled
boolean	isTerracottaClustered() Is the cache configured with Terracotta clustering?
void	propertyChange(PropertyChangeEvent evt)
void	removeAll() Removes all cached items.
void	setDiskExpiryThreadIntervalSeconds(long seconds) setDiskExpiryThreadIntervalSeconds
void	setDiskPersistent(boolean diskPersistent) setDiskPersistent
void	setEnabled(boolean enabled) Enabled/disable the cache.
void	setEternal(boolean eternal) setEternal
void	setLoggingEnabled(boolean enabled) setLoggingEnabled
void	setMaxBytesLocalDisk(long maxBytes) setMaxBytesLocalDisk
void	setMaxBytesLocalDiskAsString(String maxBytes) setMaxBytesLocalDisk
void	setMaxBytesLocalHeap(long maxBytes) setMaxBytesLocalHeap
void	setMaxBytesLocalHeapAsString(String maxBytes) setMaxBytesLocalHeap
void	setMaxElementsInMemory(int maxElements) setMaxElementsInMemory
void	setMaxElementsOnDisk(int maxElements) setMaxElementsOnDisk
void	setMaxEntriesLocalDisk(long maxEntries) setMaxEntriesLocalDisk
void	setMaxEntriesLocalHeap(long maxEntries) setMaxEntriesLocalHeap
void	setMemoryStoreEvictionPolicy(String evictionPolicy) setMemoryStoreEvictionPolicy
void	setNodeBulkLoadEnabled(boolean bulkLoadEnabled) Enabled/disable bulk-load mode for this node.
void	setNodeCoherent(boolean coherent) Deprecated. use setNodeBulkLoadEnabled(boolean) instead
void	setOverflowToDisk(boolean overflowToDisk) setOverflowToDisk
void	setStatisticsEnabled(boolean statsEnabled) Controls the statistics.
void	setTimeToIdleSeconds(long tti) setTimeToIdleSeconds
void	setTimeToLiveSeconds(long ttl) setTimeToLiveSeconds

Methods inherited from class net.sf.ehcache.hibernate.management.impl.BaseEmitterBean

addNotificationListener, dispose, removeNotificationListener, removeNotificationListener, sendNotification, sendNotification, sendNotification

Methods inherited from class javax.management.StandardMBean

cacheMBeanInfo, getAttribute, getAttributes, getCachedMBeanInfo, getClassName, getConstructors, getDescription, getDescription, getDescription, getDescription, getDescription, getDescription, getDescription, getImpact, getImplementation, getImplementationClass, getMBeanInfo, getMBeanInterface, getParameterName, getParameterName, invoke, postDeregister, postRegister, preDeregister, preRegister, setAttribute, setAttributes, setImplementation

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.sf.ehcache.statistics.sampled.SampledCacheStatistics

dispose

Constructor Detail

SampledCache

public SampledCache(Ehcache cache)
             throws NotCompliantMBeanException

Constructor accepting the backing Ehcache

Parameters:

cache - the cache object to use in initializing this sampled jmx mbean

Throws:

NotCompliantMBeanException - if object doesn't comply with mbean spec

Method Detail

isEnabled

public boolean isEnabled()

Is the cache enabled?

Specified by:

isEnabled in interface CacheSampler

setEnabled

public void setEnabled(boolean enabled)

Enabled/disable the cache.

Specified by:

setEnabled in interface CacheSampler

isClusterBulkLoadEnabled

public boolean isClusterBulkLoadEnabled()

Is the cache in bulk-load mode cluster-wide?

Specified by:

isClusterBulkLoadEnabled in interface CacheSampler

isNodeBulkLoadEnabled

public boolean isNodeBulkLoadEnabled()

Is the cache in bulk-load mode locally?

Specified by:

isNodeBulkLoadEnabled in interface CacheSampler

setNodeBulkLoadEnabled

public void setNodeBulkLoadEnabled(boolean bulkLoadEnabled)

Enabled/disable bulk-load mode for this node.

Specified by:

setNodeBulkLoadEnabled in interface CacheSampler

flush

public void flush()

Flushes all cache items from memory to the disk store, and from the DiskStore to disk.

Specified by:

flush in interface CacheSampler

getCacheName

public String getCacheName()

Specified by:

getCacheName in interface LiveCacheStatistics

Returns:

the name of the Ehcache

getStatus

public String getStatus()

Gets the status attribute of the Cache.

Specified by:

getStatus in interface CacheSampler

Returns:

The status value from the Status enum class

removeAll

public void removeAll()

Removes all cached items.

Specified by:

removeAll in interface CacheSampler

getAverageGetTimeMostRecentSample

public long getAverageGetTimeMostRecentSample()

Get most recent value for average time taken for get() operation in the cache

Specified by:

getAverageGetTimeMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample of average get time taken for a get operation

getAverageGetTimeNanosMostRecentSample

public long getAverageGetTimeNanosMostRecentSample()

Description copied from interface: SampledCacheStatistics

Get most recent value for average time taken for get() operation in the cache

Specified by:

getAverageGetTimeNanosMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample of average get time taken for a get operation

getCacheEvictionRate

public long getCacheEvictionRate()

Specified by:

getCacheEvictionRate in interface CacheSampler

Returns:

eviction rate

getCacheElementEvictedMostRecentSample

public long getCacheElementEvictedMostRecentSample()

Get most recent value element evicted from cache

Specified by:

getCacheElementEvictedMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for element evicted count

getCacheExpirationRate

public long getCacheExpirationRate()

Specified by:

getCacheExpirationRate in interface CacheSampler

Returns:

expiration rate

getCacheElementExpiredMostRecentSample

public long getCacheElementExpiredMostRecentSample()

Get most recent value element expired from cache

Specified by:

getCacheElementExpiredMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent value for element expired count

getCachePutRate

public long getCachePutRate()

Specified by:

getCachePutRate in interface CacheSampler

Returns:

put rate

getCacheElementPutMostRecentSample

public long getCacheElementPutMostRecentSample()

Get most recent value element puts in the cache

Specified by:

getCacheElementPutMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for number of element puts

getCacheRemoveRate

public long getCacheRemoveRate()

Specified by:

getCacheRemoveRate in interface CacheSampler

Returns:

remove rate

getCacheElementRemovedMostRecentSample

public long getCacheElementRemovedMostRecentSample()

Get most recent value element removed from cache

Specified by:

getCacheElementRemovedMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for element removed count

getCacheUpdateRate

public long getCacheUpdateRate()

Specified by:

getCacheUpdateRate in interface CacheSampler

Returns:

update rate

getCacheElementUpdatedMostRecentSample

public long getCacheElementUpdatedMostRecentSample()

Get most recent value element updates , i.e. put() on elements with already existing keys in the cache

Specified by:

getCacheElementUpdatedMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sampled value for element update count

getCacheInMemoryHitRate

public long getCacheInMemoryHitRate()

Specified by:

getCacheInMemoryHitRate in interface CacheSampler

Returns:

in-memory hit rate

getCacheHitInMemoryMostRecentSample

public long getCacheHitInMemoryMostRecentSample()

Get most recent value for in-memory cache hit

Specified by:

getCacheHitInMemoryMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache hit count in memory

getCacheOffHeapHitRate

public long getCacheOffHeapHitRate()

Specified by:

getCacheOffHeapHitRate in interface CacheSampler

Returns:

off-heap hit rate

getCacheHitOffHeapMostRecentSample

public long getCacheHitOffHeapMostRecentSample()

Get most recent value for off-heap cache hit

Specified by:

getCacheHitOffHeapMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache hit count in off-heap

getCacheHitRate

public long getCacheHitRate()

Specified by:

getCacheHitRate in interface CacheSampler

Returns:

hit rate

getCacheHitMostRecentSample

public long getCacheHitMostRecentSample()

Get most recent value for cache hit

Specified by:

getCacheHitMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache hit count

getCacheOnDiskHitRate

public long getCacheOnDiskHitRate()

Specified by:

getCacheOnDiskHitRate in interface CacheSampler

Returns:

on-disk hit rate

getCacheHitOnDiskMostRecentSample

public long getCacheHitOnDiskMostRecentSample()

Get most recent value for on-disk cache hit

Specified by:

getCacheHitOnDiskMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache hit count on disk

getCacheMissExpiredMostRecentSample

public long getCacheMissExpiredMostRecentSample()

Get most recent value for cache miss as result of the element getting expired

Specified by:

getCacheMissExpiredMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss count and the reason for miss being the element got expired

getCacheMissRate

public long getCacheMissRate()

Specified by:

getCacheMissRate in interface CacheSampler

Returns:

miss rate

getCacheMissMostRecentSample

public long getCacheMissMostRecentSample()

Get most recent value for cache miss

Specified by:

getCacheMissMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss count

getCacheInMemoryMissRate

public long getCacheInMemoryMissRate()

Specified by:

getCacheInMemoryMissRate in interface CacheSampler

Returns:

in-memory miss rate

getCacheMissInMemoryMostRecentSample

public long getCacheMissInMemoryMostRecentSample()

Get most recent value for in-memory cache miss

Specified by:

getCacheMissInMemoryMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss count in memory

getCacheOffHeapMissRate

public long getCacheOffHeapMissRate()

Specified by:

getCacheOffHeapMissRate in interface CacheSampler

Returns:

off-heap miss rate

getCacheMissOffHeapMostRecentSample

public long getCacheMissOffHeapMostRecentSample()

Get most recent value for off-heap cache miss

Specified by:

getCacheMissOffHeapMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss count in off-heap

getCacheOnDiskMissRate

public long getCacheOnDiskMissRate()

Specified by:

getCacheOnDiskMissRate in interface CacheSampler

Returns:

on-disk miss rate

getCacheMissOnDiskMostRecentSample

public long getCacheMissOnDiskMostRecentSample()

Get most recent value for on-disk cache miss

Specified by:

getCacheMissOnDiskMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss count on disk

getCacheMissNotFoundMostRecentSample

public long getCacheMissNotFoundMostRecentSample()

Get most recent value for cache miss as result of the element not found in cache

Specified by:

getCacheMissNotFoundMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent sample for cache miss not found count

getStatisticsAccuracy

public int getStatisticsAccuracy()

Accurately measuring statistics can be expensive. Returns the current accuracy setting.

Specified by:

getStatisticsAccuracy in interface LiveCacheStatistics

Specified by:

getStatisticsAccuracy in interface SampledCacheStatistics

Returns:

one of Statistics.STATISTICS_ACCURACY_BEST_EFFORT, Statistics.STATISTICS_ACCURACY_GUARANTEED, Statistics.STATISTICS_ACCURACY_NONE

getStatisticsAccuracyDescription

public String getStatisticsAccuracyDescription()

Accurately measuring statistics can be expensive. Returns the current accuracy setting.

Specified by:

getStatisticsAccuracyDescription in interface LiveCacheStatistics

Specified by:

getStatisticsAccuracyDescription in interface SampledCacheStatistics

Returns:

a human readable description of the accuracy setting. One of "None", "Best Effort" or "Guaranteed".

clearStatistics

public void clearStatistics()

Clear both sampled and cumulative statistics

Specified by:

clearStatistics in interface CacheSampler

Specified by:

clearStatistics in interface LiveCacheStatistics

Specified by:

clearStatistics in interface SampledCacheStatistics

isStatisticsEnabled

public boolean isStatisticsEnabled()

Returns true if statistics is enabled

Specified by:

isStatisticsEnabled in interface LiveCacheStatistics

Returns:

true if statistics is enabled

isSampledStatisticsEnabled

public boolean isSampledStatisticsEnabled()

Returns true if statistics collection is enabled for cache, otherwise false

Specified by:

isSampledStatisticsEnabled in interface SampledCacheStatistics

Returns:

true if sampled statistics is enabled, false otherwise

isTerracottaClustered

public boolean isTerracottaClustered()

Is the cache configured with Terracotta clustering?

Specified by:

isTerracottaClustered in interface CacheSampler

Returns:

true if clustered with terracotta

getTerracottaConsistency

public String getTerracottaConsistency()

Returns a textual description of a Terracotta-clustered cache's consistency mode.

Specified by:

getTerracottaConsistency in interface CacheSampler

Returns:

"STRONG", "EVENTUAL", or "na" if the cache is not Terracotta-clustered

enableStatistics

public void enableStatistics()

Enables statistics collection

Specified by:

enableStatistics in interface CacheSampler

See Also:

CacheSampler.enableStatistics()

disableStatistics

public void disableStatistics()

Disables statistics collection. Also disables sampled statistics if it is enabled.

Specified by:

disableStatistics in interface CacheSampler

See Also:

CacheSampler.disableStatistics()

setStatisticsEnabled

public void setStatisticsEnabled(boolean statsEnabled)

Controls the statistics. Also controls sampled statistics if it is enabled.

Specified by:

setStatisticsEnabled in interface CacheSampler

See Also:

CacheSampler.setStatisticsEnabled(boolean)

enableSampledStatistics

public void enableSampledStatistics()

Enables statistics collection. As it requires that normal statistics collection to be enabled, it enables it if its not already

Specified by:

enableSampledStatistics in interface CacheSampler

See Also:

CacheSampler.enableSampledStatistics()

disableSampledStatistics

public void disableSampledStatistics()

Disables statistics collection

Specified by:

disableSampledStatistics in interface CacheSampler

See Also:

()

setNodeCoherent

@Deprecated
public void setNodeCoherent(boolean coherent)

Deprecated. use setNodeBulkLoadEnabled(boolean) instead

Enabled/disable cache coherence mode for this node.

Specified by:

setNodeCoherent in interface SampledCacheMBean

isClusterCoherent

@Deprecated
public boolean isClusterCoherent()

Deprecated.

Is the cache coherent cluster-wide?

Specified by:

isClusterCoherent in interface SampledCacheMBean

isNodeCoherent

@Deprecated
public boolean isNodeCoherent()

Deprecated.

Is the cache coherent locally?

Specified by:

isNodeCoherent in interface SampledCacheMBean

getCacheAverageGetTime

public long getCacheAverageGetTime()

Specified by:

getCacheAverageGetTime in interface CacheSampler

Returns:

average get time (nanos.)

getAverageGetTimeMillis

public float getAverageGetTimeMillis()

Average time in milliseconds taken to get an element from the cache.

Specified by:

getAverageGetTimeMillis in interface LiveCacheStatistics

Returns:

Average time taken for a get operation in milliseconds

See Also:

LiveCacheStatistics.getAverageGetTimeMillis()

getAverageGetTimeNanos

public long getAverageGetTimeNanos()

Average time in nanoseconds taken to get an element from the cache.

Specified by:

getAverageGetTimeNanos in interface LiveCacheStatistics

Returns:

Average time taken for a get operation in nanoseconds

See Also:

LiveCacheStatistics.getAverageGetTimeNanos()

getMaxGetTimeMillis

public long getMaxGetTimeMillis()

Return maximum time taken for a get operation in the cache in milliseconds

Specified by:

getMaxGetTimeMillis in interface LiveCacheStatistics

Returns:

maximum time taken for a get operation in the cache in milliseconds

See Also:

LiveCacheStatistics.getMaxGetTimeMillis()

getMinGetTimeMillis

public long getMinGetTimeMillis()

Return minimum time taken for a get operation in the cache in milliseconds

Specified by:

getMinGetTimeMillis in interface LiveCacheStatistics

Returns:

minimum time taken for a get operation in the cache in milliseconds

See Also:

LiveCacheStatistics.getMinGetTimeMillis()

getMaxGetTimeNanos

public long getMaxGetTimeNanos()

Return maximum time taken for a get operation in the cache in milliseconds

Specified by:

getMaxGetTimeNanos in interface LiveCacheStatistics

Returns:

maximum time taken for a get operation in the cache in milliseconds

See Also:

LiveCacheStatistics.getMaxGetTimeNanos()

getMinGetTimeNanos

public long getMinGetTimeNanos()

Return minimum time taken for a get operation in the cache in nanoseconds

Specified by:

getMinGetTimeNanos in interface LiveCacheStatistics

Returns:

minimum time taken for a get operation in the cache in nanoseconds

See Also:

LiveCacheStatistics.getMinGetTimeNanos()

getXaCommitCount

public long getXaCommitCount()

Return the Cache's XAResource commit calls count

Specified by:

getXaCommitCount in interface LiveCacheStatistics

Returns:

the Cache's XAResource commit calls count

See Also:

LiveCacheStatistics.getXaCommitCount()

getXaRollbackCount

public long getXaRollbackCount()

Return the Cache's XAResource rollback calls count

Specified by:

getXaRollbackCount in interface LiveCacheStatistics

Returns:

the Cache's XAResource rollback calls count

See Also:

LiveCacheStatistics.getXaRollbackCount()

getXaRecoveredCount

public long getXaRecoveredCount()

Return the Cache's XAResource recovered XIDs count

Specified by:

getXaRecoveredCount in interface LiveCacheStatistics

Returns:

the Cache's XAResource recovered XIDs count

See Also:

LiveCacheStatistics.getXaRecoveredCount()

getHasWriteBehindWriter

public boolean getHasWriteBehindWriter()

Is there a registered Write-behind CacheWriter

Specified by:

getHasWriteBehindWriter in interface CacheSampler

getWriterQueueLength

public long getWriterQueueLength()

Returns the total length of all write-behind queues for this cache

Specified by:

getWriterQueueLength in interface CacheSampler

Specified by:

getWriterQueueLength in interface LiveCacheStatistics

Returns:

writer-behind queue length

See Also:

LiveCacheStatistics.getWriterQueueLength()

getWriterMaxQueueSize

public int getWriterMaxQueueSize()

Returns the maximum size of any write-behind queues.

Specified by:

getWriterMaxQueueSize in interface CacheSampler

Returns:

Maximum elements that can be queued for processing by the write-behind writer

See Also:

CacheWriterConfiguration.getWriteBehindMaxQueueSize()

getWriterConcurrency

public int getWriterConcurrency()

Returns the number of configured write-behind queues/threads.

Specified by:

getWriterConcurrency in interface CacheSampler

Returns:

Number of configured processing queues/threads for use by the write-behind writer

See Also:

CacheWriterConfiguration.getWriteBehindConcurrency()

getCacheHitCount

public long getCacheHitCount()

The number of times a requested item was found in the cache.

Specified by:

getCacheHitCount in interface LiveCacheStatistics

Returns:

the number of times a requested item was found in the cache

See Also:

LiveCacheStatistics.getCacheHitCount()

getCacheMissCount

public long getCacheMissCount()

Number of times a requested element was not found in the cache.

Specified by:

getCacheMissCount in interface LiveCacheStatistics

Returns:

the number of times a requested element was not found in the cache

See Also:

LiveCacheStatistics.getCacheMissCount()

getInMemoryMissCount

public long getInMemoryMissCount()

Number of times a requested item was not found in the Memory Store.

Specified by:

getInMemoryMissCount in interface LiveCacheStatistics

Returns:

the number of times a requested item was not found in memory

See Also:

LiveCacheStatistics.getInMemoryMissCount()

getOffHeapMissCount

public long getOffHeapMissCount()

Number of times a requested item was not found in the off-heap store.

Specified by:

getOffHeapMissCount in interface LiveCacheStatistics

Returns:

the number of times a requested item was not found in off-heap

See Also:

LiveCacheStatistics.getOffHeapMissCount()

getOnDiskMissCount

public long getOnDiskMissCount()

Number of times a requested item was not found in the Disk Store.

Specified by:

getOnDiskMissCount in interface LiveCacheStatistics

Returns:

the number of times a requested item was not found on Disk, or 0 if there is no disk storage configured.

See Also:

LiveCacheStatistics.getOnDiskMissCount()

getCacheMissCountExpired

public long getCacheMissCountExpired()

Specified by:

getCacheMissCountExpired in interface LiveCacheStatistics

Returns:

the number of times a requested element was not found in the cache and the reason being the element already expired

See Also:

LiveCacheStatistics.getCacheMissCountExpired()

getDiskExpiryThreadIntervalSeconds

public long getDiskExpiryThreadIntervalSeconds()

Configuration property accessor

Specified by:

getDiskExpiryThreadIntervalSeconds in interface CacheSampler

Returns:

Value for disk expiry thread interval in seconds specified in config

See Also:

CacheSampler.getDiskExpiryThreadIntervalSeconds()

setDiskExpiryThreadIntervalSeconds

public void setDiskExpiryThreadIntervalSeconds(long seconds)

setDiskExpiryThreadIntervalSeconds

Specified by:

setDiskExpiryThreadIntervalSeconds in interface CacheSampler

See Also:

CacheSampler.setDiskExpiryThreadIntervalSeconds(long)

getMaxEntriesLocalHeap

public long getMaxEntriesLocalHeap()

Configuration property accessor

Specified by:

getMaxEntriesLocalHeap in interface CacheSampler

Returns:

Max entries local heap config setting value

See Also:

CacheSampler.getMaxEntriesLocalHeap()

setMaxEntriesLocalHeap

public void setMaxEntriesLocalHeap(long maxEntries)

setMaxEntriesLocalHeap

Specified by:

setMaxEntriesLocalHeap in interface CacheSampler

See Also:

CacheSampler.setMaxEntriesLocalHeap(long)

getMaxBytesLocalHeap

public long getMaxBytesLocalHeap()

Configuration property accessor

Specified by:

getMaxBytesLocalHeap in interface CacheSampler

Returns:

Max bytes local heap config setting value

See Also:

CacheSampler.getMaxBytesLocalHeap()

setMaxBytesLocalHeap

public void setMaxBytesLocalHeap(long maxBytes)

setMaxBytesLocalHeap

Specified by:

setMaxBytesLocalHeap in interface CacheSampler

See Also:

CacheSampler.setMaxBytesLocalHeap(long)

setMaxBytesLocalHeapAsString

public void setMaxBytesLocalHeapAsString(String maxBytes)

setMaxBytesLocalHeap

Specified by:

setMaxBytesLocalHeapAsString in interface CacheSampler

See Also:

CacheSampler.setMaxBytesLocalHeapAsString(String)

getMaxBytesLocalHeapAsString

public String getMaxBytesLocalHeapAsString()

Configuration property accessor

Specified by:

getMaxBytesLocalHeapAsString in interface CacheSampler

Returns:

Max bytes local heap config setting value as string

See Also:

CacheSampler.getMaxBytesLocalHeapAsString()

getMaxElementsInMemory

public int getMaxElementsInMemory()

Configuration property accessor

Specified by:

getMaxElementsInMemory in interface SampledCacheMBean

Returns:

Max elements in memory config setting value

setMaxElementsInMemory

public void setMaxElementsInMemory(int maxElements)

setMaxElementsInMemory

Specified by:

setMaxElementsInMemory in interface SampledCacheMBean

getMaxEntriesLocalDisk

public long getMaxEntriesLocalDisk()

Configuration property accessor

Specified by:

getMaxEntriesLocalDisk in interface CacheSampler

Returns:

Max entries local disk config setting value

See Also:

CacheSampler.getMaxEntriesLocalDisk()

setMaxEntriesLocalDisk

public void setMaxEntriesLocalDisk(long maxEntries)

setMaxEntriesLocalDisk

Specified by:

setMaxEntriesLocalDisk in interface CacheSampler

See Also:

CacheSampler.setMaxEntriesLocalDisk(long)

setMaxBytesLocalDisk

public void setMaxBytesLocalDisk(long maxBytes)

setMaxBytesLocalDisk

Specified by:

setMaxBytesLocalDisk in interface CacheSampler

See Also:

CacheSampler.setMaxBytesLocalDisk(long)

setMaxBytesLocalDiskAsString

public void setMaxBytesLocalDiskAsString(String maxBytes)

setMaxBytesLocalDisk

Specified by:

setMaxBytesLocalDiskAsString in interface CacheSampler

See Also:

CacheSampler.setMaxBytesLocalDiskAsString(String)

getMaxBytesLocalDiskAsString

public String getMaxBytesLocalDiskAsString()

Configuration property accessor

Specified by:

getMaxBytesLocalDiskAsString in interface CacheSampler

Returns:

Max bytes local disk config setting value as string

See Also:

CacheSampler.getMaxBytesLocalDiskAsString()

getMaxElementsOnDisk

public int getMaxElementsOnDisk()

Configuration property accessor

Specified by:

getMaxElementsOnDisk in interface CacheSampler

Returns:

Max elements on disk config setting value

See Also:

CacheSampler.getMaxElementsOnDisk()

setMaxElementsOnDisk

public void setMaxElementsOnDisk(int maxElements)

setMaxElementsOnDisk

Specified by:

setMaxElementsOnDisk in interface CacheSampler

See Also:

CacheSampler.setMaxElementsOnDisk(int)

getMaxBytesLocalDisk

public long getMaxBytesLocalDisk()

Configuration property accessor

Specified by:

getMaxBytesLocalDisk in interface CacheSampler

Returns:

Max bytes local disk config setting value

See Also:

CacheSampler.getMaxBytesLocalDisk()

getMaxBytesLocalOffHeap

public long getMaxBytesLocalOffHeap()

Configuration property accessor

Specified by:

getMaxBytesLocalOffHeap in interface CacheSampler

Returns:

Max bytes local offheap config setting value

See Also:

CacheSampler.getMaxBytesLocalOffHeap()

getMaxBytesLocalOffHeapAsString

public String getMaxBytesLocalOffHeapAsString()

Configuration property accessor

Specified by:

getMaxBytesLocalOffHeapAsString in interface CacheSampler

Returns:

Max bytes local offheap config setting value as string

See Also:

CacheSampler.getMaxBytesLocalOffHeapAsString()

getMemoryStoreEvictionPolicy

public String getMemoryStoreEvictionPolicy()

Configuration property accessor

Specified by:

getMemoryStoreEvictionPolicy in interface CacheSampler

Returns:

a String representation of the policy

See Also:

CacheSampler.getMemoryStoreEvictionPolicy()

setMemoryStoreEvictionPolicy

public void setMemoryStoreEvictionPolicy(String evictionPolicy)

setMemoryStoreEvictionPolicy

Specified by:

setMemoryStoreEvictionPolicy in interface CacheSampler

See Also:

CacheSampler.setMemoryStoreEvictionPolicy(String)

getTimeToIdleSeconds

public long getTimeToIdleSeconds()

Configuration property accessor

Specified by:

getTimeToIdleSeconds in interface CacheSampler

Returns:

TTI in config

See Also:

CacheSampler.getTimeToIdleSeconds()

setTimeToIdleSeconds

public void setTimeToIdleSeconds(long tti)

setTimeToIdleSeconds

Specified by:

setTimeToIdleSeconds in interface CacheSampler

See Also:

CacheSampler.setTimeToIdleSeconds(long)

getTimeToLiveSeconds

public long getTimeToLiveSeconds()

Configuration property accessor

Specified by:

getTimeToLiveSeconds in interface CacheSampler

Returns:

TTL in config

See Also:

CacheSampler.getTimeToLiveSeconds()

setTimeToLiveSeconds

public void setTimeToLiveSeconds(long ttl)

setTimeToLiveSeconds

Specified by:

setTimeToLiveSeconds in interface CacheSampler

See Also:

CacheSampler.setTimeToLiveSeconds(long)

isDiskPersistent

public boolean isDiskPersistent()

Configuration property accessor

Specified by:

isDiskPersistent in interface CacheSampler

Returns:

true if configured with disk persistence

See Also:

CacheSampler.isDiskPersistent()

setDiskPersistent

public void setDiskPersistent(boolean diskPersistent)

setDiskPersistent

Specified by:

setDiskPersistent in interface CacheSampler

See Also:

CacheSampler.setDiskPersistent(boolean)

isEternal

public boolean isEternal()

Configuration property accessor

Specified by:

isEternal in interface CacheSampler

Returns:

true if set to eternal in config

See Also:

CacheSampler.isEternal()

setEternal

public void setEternal(boolean eternal)

setEternal

Specified by:

setEternal in interface CacheSampler

See Also:

CacheSampler.setEternal(boolean)

isOverflowToDisk

public boolean isOverflowToDisk()

Configuration property accessor

Specified by:

isOverflowToDisk in interface CacheSampler

Returns:

true if overflow to disk specified in config

See Also:

CacheSampler.isOverflowToDisk()

setOverflowToDisk

public void setOverflowToDisk(boolean overflowToDisk)

setOverflowToDisk

Specified by:

setOverflowToDisk in interface CacheSampler

See Also:

CacheSampler.setOverflowToDisk(boolean)

isLoggingEnabled

public boolean isLoggingEnabled()

Configuration property accessor

Specified by:

isLoggingEnabled in interface CacheSampler

Returns:

true if logging is enabled on the cache

See Also:

CacheSampler.isLoggingEnabled()

setLoggingEnabled

public void setLoggingEnabled(boolean enabled)

setLoggingEnabled

Specified by:

setLoggingEnabled in interface CacheSampler

See Also:

CacheSampler.setLoggingEnabled(boolean)

isPinned

public boolean isPinned()

Configuration property accessor

Specified by:

isPinned in interface CacheSampler

Returns:

true if the cache is pinned

See Also:

CacheSampler.isPinned()

getPinnedToStore

public String getPinnedToStore()

Configuration property accessor

Specified by:

getPinnedToStore in interface CacheSampler

Returns:

the store to which this cache is pinned

See Also:

CacheSampler.getPinnedToStore()

getEvictedCount

public long getEvictedCount()

Number of elements evicted from the cache

Specified by:

getEvictedCount in interface LiveCacheStatistics

Returns:

Number of elements evicted from the cache

See Also:

LiveCacheStatistics.getEvictedCount()

getExpiredCount

public long getExpiredCount()

Number of elements expired since creation or last clear

Specified by:

getExpiredCount in interface LiveCacheStatistics

Returns:

Number of expired elements

See Also:

LiveCacheStatistics.getExpiredCount()

getInMemoryHitCount

public long getInMemoryHitCount()

Number of times a requested item was found in the Memory Store.

Specified by:

getInMemoryHitCount in interface LiveCacheStatistics

Returns:

the number of times a requested item was found in memory

See Also:

LiveCacheStatistics.getInMemoryHitCount()

getInMemorySize

@Deprecated
public long getInMemorySize()

Deprecated. use getLocalHeapSize()

Number of elements in the MemoryStore

Specified by:

getInMemorySize in interface LiveCacheStatistics

Returns:

the number of elements in memory

See Also:

getInMemorySize()

getOffHeapHitCount

public long getOffHeapHitCount()

Number of times a requested item was found in the off-heap store.

Specified by:

getOffHeapHitCount in interface LiveCacheStatistics

Returns:

the number of times a requested item was found in off-heap

See Also:

LiveCacheStatistics.getOffHeapHitCount()

getOffHeapSize

@Deprecated
public long getOffHeapSize()

Deprecated. use getLocalOffHeapSize()

Number of elements in the off-heap store

Specified by:

getOffHeapSize in interface LiveCacheStatistics

Returns:

the number of elements in off-heap

See Also:

LiveCacheStatistics.getOffHeapSize()

getOnDiskHitCount

public long getOnDiskHitCount()

Number of times a requested item was found in the Disk Store.

Specified by:

getOnDiskHitCount in interface LiveCacheStatistics

Returns:

the number of times a requested item was found on Disk, or 0 if there is no disk storage configured.

See Also:

LiveCacheStatistics.getOnDiskHitCount()

getOnDiskSize

@Deprecated
public long getOnDiskSize()

Deprecated. use getLocalDiskSize()

Number of elements in the DiskStore

Specified by:

getOnDiskSize in interface LiveCacheStatistics

Returns:

number of elements on disk

See Also:

LiveCacheStatistics.getOnDiskSize()

getLocalDiskSize

public long getLocalDiskSize()

Number of entries in the DiskStore

Specified by:

getLocalDiskSize in interface LiveCacheStatistics

Returns:

number of elements on disk

See Also:

LiveCacheStatistics.getLocalDiskSize()

getLocalHeapSize

public long getLocalHeapSize()

Number of entries in the MemoryStore

Specified by:

getLocalHeapSize in interface LiveCacheStatistics

Returns:

the number of elements in memory

See Also:

LiveCacheStatistics.getLocalHeapSize()

getLocalOffHeapSize

public long getLocalOffHeapSize()

Number of entries in the off-heap store

Specified by:

getLocalOffHeapSize in interface LiveCacheStatistics

Returns:

the number of elements in off-heap

See Also:

LiveCacheStatistics.getLocalOffHeapSize()

getLocalDiskSizeInBytes

public long getLocalDiskSizeInBytes()

Number of of bytes used by entries in the DiskStore

Specified by:

getLocalDiskSizeInBytes in interface LiveCacheStatistics

Returns:

number of bytes used by elements on disk

See Also:

LiveCacheStatistics.getLocalDiskSizeInBytes()

getLocalHeapSizeInBytes

public long getLocalHeapSizeInBytes()

Number of of bytes used by entries in the MemoryStore

Specified by:

getLocalHeapSizeInBytes in interface LiveCacheStatistics

Returns:

the number of of bytes used by elements in memory

See Also:

LiveCacheStatistics.getLocalHeapSizeInBytes()

getLocalOffHeapSizeInBytes

public long getLocalOffHeapSizeInBytes()

Number of of bytes used by entries in the off-heap store

Specified by:

getLocalOffHeapSizeInBytes in interface LiveCacheStatistics

Returns:

the number of of bytes used by elements in off-heap

See Also:

LiveCacheStatistics.getLocalOffHeapSizeInBytes()

getPutCount

public long getPutCount()

Number of puts that has happened in the cache

Specified by:

getPutCount in interface LiveCacheStatistics

Returns:

Number of puts

See Also:

LiveCacheStatistics.getPutCount()

getRemovedCount

public long getRemovedCount()

Number of elements removed since creation or last clear

Specified by:

getRemovedCount in interface LiveCacheStatistics

Returns:

Number of elements removed

See Also:

LiveCacheStatistics.getRemovedCount()

getSize

public long getSize()

Size of the cache based on current accuracy settings.

Specified by:

getSize in interface LiveCacheStatistics

Returns:

The size of the cache based on current accuracy setting

See Also:

LiveCacheStatistics.getSize()

getUpdateCount

public long getUpdateCount()

Number of updates that as happened in the cache

Specified by:

getUpdateCount in interface LiveCacheStatistics

Returns:

Number of updates

See Also:

LiveCacheStatistics.getUpdateCount()

getCacheAttributes

public Map<String,Object> getCacheAttributes()

getCacheAttributes

Returns:

map of attribute name -> value

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

Specified by:

getNotificationInfo in interface NotificationBroadcaster

Specified by:

getNotificationInfo in class BaseEmitterBean

See Also:

BaseEmitterBean.getNotificationInfo()

propertyChange

public void propertyChange(PropertyChangeEvent evt)

Specified by:

propertyChange in interface PropertyChangeListener

See Also:

PropertyChangeListener.propertyChange(java.beans.PropertyChangeEvent)

doDispose

protected void doDispose()

Dispose callback of subclasses

Specified by:

doDispose in class BaseEmitterBean

getAverageSearchTime

public long getAverageSearchTime()

Get the average search execution time for searches finishing within the last sample period

Specified by:

getAverageSearchTime in interface SampledCacheStatistics

getSearchesPerSecond

public long getSearchesPerSecond()

Get the number of searches that have finished execution in the last second

Specified by:

getSearchesPerSecond in interface SampledCacheStatistics

getTransactional

public boolean getTransactional()

Is the cache a transactional one

Specified by:

getTransactional in interface CacheSampler

See Also:

CacheConfiguration.TransactionalMode

getSearchable

public boolean getSearchable()

Is the cache configured for search

Specified by:

getSearchable in interface CacheSampler

See Also:

Searchable

getCacheSearchRate

public long getCacheSearchRate()

Specified by:

getCacheSearchRate in interface CacheSampler

Returns:

search rate

getCacheAverageSearchTime

public long getCacheAverageSearchTime()

Specified by:

getCacheAverageSearchTime in interface CacheSampler

Returns:

search time

getTransactionCommitRate

public long getTransactionCommitRate()

Specified by:

getTransactionCommitRate in interface CacheSampler

Returns:

Xa commit rate

getCacheXaCommitsMostRecentSample

public long getCacheXaCommitsMostRecentSample()

Get most recent value of XA commits

Specified by:

getCacheXaCommitsMostRecentSample in interface SampledCacheStatistics

getTransactionRollbackRate

public long getTransactionRollbackRate()

Specified by:

getTransactionRollbackRate in interface CacheSampler

Returns:

Xa rollback rate

getCacheXaRollbacksMostRecentSample

public long getCacheXaRollbacksMostRecentSample()

Get most recent value of XA rollbacks

Specified by:

getCacheXaRollbacksMostRecentSample in interface SampledCacheStatistics

getCacheHitRatio

public int getCacheHitRatio()

The ratio of hits to accesses (hits + misses).

Specified by:

getCacheHitRatio in interface LiveCacheStatistics

Returns:

the ratio of hits to (hits + misses) (0 - 100)

getCacheHitRatioMostRecentSample

public int getCacheHitRatioMostRecentSample()

Get most recent value for cache hit ratio

Specified by:

getCacheHitRatioMostRecentSample in interface SampledCacheStatistics

Returns:

Most recent value for cache hit ratio