ehcache

net.sf.ehcache.management.sampled
Interface LegacyCacheStatistics

All Known Subinterfaces:
CacheSampler, SampledCacheMBean
All Known Implementing Classes:
CacheSamplerImpl, SampledCache

public interface LegacyCacheStatistics

Interface for sampled usage statistics of a Cache

.

Since:
1.7
Author:
Abhishek Sanoujam

Method Summary
 void dispose()
          Method used to dispose this statistics.
 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 getAverageSearchTimeNanos()
          Get the average search execution time for searches finishing within the last sample period.
 long getCacheClusterOfflineCount()
          Count of cluster offline events for this node.
 long getCacheClusterOfflineMostRecentSample()
          Gets the cache cluster offline most recent sample.
 long getCacheClusterOnlineCount()
          Count of cluster online events for this node.
 long getCacheClusterOnlineMostRecentSample()
          Gets the cache cluster online most recent sample.
 long getCacheClusterRejoinCount()
          Count of cluster rejoin events for this node.
 long getCacheClusterRejoinMostRecentSample()
          Gets the cache cluster rejoin most recent sample.
 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 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.
 int getCacheHitRatio()
          The ratio of hits to accesses (hits + misses).
 int getCacheHitRatioMostRecentSample()
          Get most recent value for cache hit ratio.
 long getCacheMissCount()
          Number of times a requested element was not found in the cache.
 long getCacheMissCountExpired()
          Gets the cache miss count expired.
 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.
 String getCacheName()
          Gets the cache name.
 long getCacheXaCommitsMostRecentSample()
          Get most recent value of XA commits.
 long getCacheXaRollbacksMostRecentSample()
          Get most recent value of XA rollbacks.
 long getEvictedCount()
          Number of elements evicted from the cache.
 long getExpiredCount()
          Number of elements expired since creation or last clear.
 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 getMaxGetTimeNanos()
          Return maximum time taken for a get operation in the cache in nanoseconds.
 Long getMinGetTimeNanos()
          Return minimum time taken for a get operation in the cache in nanoseconds.
 long getNonStopFailureCount()
          Gets the non stop failure count.
 long getNonStopFailureMostRecentSample()
          Gets the non stop failure most recent sample.
 long getNonStopRejoinTimeoutCount()
          Gets the non stop rejoin timeout count.
 long getNonStopRejoinTimeoutMostRecentSample()
          Gets the non stop rejoin most recent sample.
 long getNonStopSuccessCount()
          Gets the non stop success count.
 long getNonStopSuccessMostRecentSample()
          Gets the non stop success most recent sample.
 long getNonStopTimeoutCount()
          Gets the non stop timeout count.
 long getNonStopTimeoutMostRecentSample()
          Gets the non stop timeout most recent sample.
 int getNonstopTimeoutRatio()
          Get the ratio of nonstop timeouts+rejoin timeouts to operations
 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()
 long getPutCount()
          Number of puts that has happened in the cache.
 long getPutIfAbsentMissCount()
          Number of putIfAbsent operations that missed.
 long getPutIfAbsentMissRate()
          Rate of putIfAbsent operations that missed.
 long getPutIfAbsentSuccessCount()
          Number of putIfAbsent operations that succeeded.
 long getPutIfAbsentSuccessRate()
          Rate of putIfAbsent operations that succeeded.
 long getRemovedCount()
          Number of elements removed since creation or last clear.
 long getRemoveElementMissCount()
          Number of removeElement operations that missed.
 long getRemoveElementMissRate()
          Rate of removeElement operations that missed.
 long getRemoveElementSuccessCount()
          Number of removeElement operations that succeeded
 long getRemoveElementSuccessRate()
          Rate of removeElement operations that succeeded
 long getReplaceOneArgMissCount()
          Number of one arg replace operations that missed.
 long getReplaceOneArgMissRate()
          Rate of one arg replace operations that missed.
 long getReplaceOneArgSuccessCount()
          Number of one arg replace operations that succeeded.
 long getReplaceOneArgSuccessRate()
          Rate of one arg replace operations that succeeded.
 long getReplaceTwoArgMissCount()
          Number of two arg replace operations that missed.
 long getReplaceTwoArgMissRate()
          Rate of two arg replace operations that missed.
 long getReplaceTwoArgSuccessCount()
          Number of two arg replace operations that succeeded.
 long getReplaceTwoArgSuccessRate()
          Rate of two arg replace operations that succeeded.
 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.
 long getUpdateCount()
          Number of updates that as happened in the cache.
 long getWriterQueueLength()
          Gets the size of the write-behind queue, if any.
 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 isLocalHeapCountBased()
          Check if the local heap is measured with ARC or in element count.
 

Method Detail

getCacheHitCount

long getCacheHitCount()
The number of times a requested item was found in the cache.

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

getInMemoryHitCount

long getInMemoryHitCount()
Number of times a requested item was found in the Memory Store.

Returns:
the number of times a requested item was found in memory

getOffHeapHitCount

long getOffHeapHitCount()
Number of times a requested item was found in the off-heap store.

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

getOnDiskHitCount

long getOnDiskHitCount()
Number of times a requested item was found in the Disk Store.

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

getCacheMissCount

long getCacheMissCount()
Number of times a requested element was not found in the cache.

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

getInMemoryMissCount

long getInMemoryMissCount()
Number of times a requested item was not found in the Memory Store.

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

getOffHeapMissCount

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

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

getOnDiskMissCount

long getOnDiskMissCount()
Number of times a requested item was not found in the Disk Store.

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

getCacheMissCountExpired

long getCacheMissCountExpired()
Gets the cache miss count expired.

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

getCacheHitRatio

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

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

getNonstopTimeoutRatio

int getNonstopTimeoutRatio()
Get the ratio of nonstop timeouts+rejoin timeouts to operations

Returns:
the ratio of timeouts to operation (0 - 100)

getSize

long getSize()
Size of the cache based on current accuracy settings.

Returns:
The size of the cache based on current accuracy setting

getInMemorySize

@Deprecated
long getInMemorySize()
Deprecated. use getLocalHeapSize()

Number of elements in the MemoryStore.

Returns:
the number of elements in memory

getOffHeapSize

@Deprecated
long getOffHeapSize()
Deprecated. use getLocalOffHeapSize()

Number of elements in the off-heap store.

Returns:
the number of elements in off-heap

getOnDiskSize

@Deprecated
long getOnDiskSize()
Deprecated. use getLocalDiskSize()

Number of elements in the DiskStore.

Returns:
number of elements on disk

getLocalHeapSize

long getLocalHeapSize()
Number of entries in the MemoryStore.

Returns:
the number of elements in memory

getLocalOffHeapSize

long getLocalOffHeapSize()
Number of entries in the off-heap store.

Returns:
the number of elements in off-heap

getLocalDiskSize

long getLocalDiskSize()
Number of entries in the DiskStore.

Returns:
number of elements on disk

getLocalHeapSizeInBytes

long getLocalHeapSizeInBytes()
Number of of bytes used by entries in the MemoryStore.

Returns:
the number of of bytes used by elements in memory

getLocalOffHeapSizeInBytes

long getLocalOffHeapSizeInBytes()
Number of of bytes used by entries in the off-heap store.

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

getLocalDiskSizeInBytes

long getLocalDiskSizeInBytes()
Number of of bytes used by entries in the DiskStore.

Returns:
number of bytes used by elements on disk

getAverageGetTimeNanos

long getAverageGetTimeNanos()
Average time in nanoseconds taken to get an element from the cache.

Returns:
Average time taken for a get operation in nanoseconds

getEvictedCount

long getEvictedCount()
Number of elements evicted from the cache.

Returns:
Number of elements evicted from the cache

getPutCount

long getPutCount()
Number of puts that has happened in the cache.

Returns:
Number of puts

getUpdateCount

long getUpdateCount()
Number of updates that as happened in the cache.

Returns:
Number of updates

getReplaceOneArgSuccessCount

long getReplaceOneArgSuccessCount()
Number of one arg replace operations that succeeded.

Returns:
Number of replaces

getReplaceOneArgSuccessRate

long getReplaceOneArgSuccessRate()
Rate of one arg replace operations that succeeded. Similar to most recent smaple

Returns:
Rate of replaces

getReplaceOneArgMissCount

long getReplaceOneArgMissCount()
Number of one arg replace operations that missed.

Returns:
Number of replace misses

getReplaceOneArgMissRate

long getReplaceOneArgMissRate()
Rate of one arg replace operations that missed.

Returns:
Rate of replace misses

getReplaceTwoArgSuccessCount

long getReplaceTwoArgSuccessCount()
Number of two arg replace operations that succeeded.

Returns:
Number of replaces

getReplaceTwoArgSuccessRate

long getReplaceTwoArgSuccessRate()
Rate of two arg replace operations that succeeded.

Returns:
Rate of replaces

getReplaceTwoArgMissCount

long getReplaceTwoArgMissCount()
Number of two arg replace operations that missed.

Returns:
Number of replace misses

getReplaceTwoArgMissRate

long getReplaceTwoArgMissRate()
Rate of two arg replace operations that missed.

Returns:
Rate of replace misses

getPutIfAbsentSuccessCount

long getPutIfAbsentSuccessCount()
Number of putIfAbsent operations that succeeded.

Returns:
Number of putIfAbsents

getPutIfAbsentSuccessRate

long getPutIfAbsentSuccessRate()
Rate of putIfAbsent operations that succeeded.

Returns:
Rate of putIfAbsents

getPutIfAbsentMissCount

long getPutIfAbsentMissCount()
Number of putIfAbsent operations that missed.

Returns:
Number of putIfAbsent misses

getPutIfAbsentMissRate

long getPutIfAbsentMissRate()
Rate of putIfAbsent operations that missed.

Returns:
Rate of putIfAbsent misses

getRemoveElementSuccessCount

long getRemoveElementSuccessCount()
Number of removeElement operations that succeeded

Returns:
Number of removeElement operations

getRemoveElementSuccessRate

long getRemoveElementSuccessRate()
Rate of removeElement operations that succeeded

Returns:
Rate of removeElement operations

getRemoveElementMissCount

long getRemoveElementMissCount()
Number of removeElement operations that missed.

Returns:
Number of removeElement misses

getRemoveElementMissRate

long getRemoveElementMissRate()
Rate of removeElement operations that missed.

Returns:
Rate of removeElement misses

getExpiredCount

long getExpiredCount()
Number of elements expired since creation or last clear.

Returns:
Number of expired elements

getRemovedCount

long getRemovedCount()
Number of elements removed since creation or last clear.

Returns:
Number of elements removed

getCacheClusterOfflineCount

long getCacheClusterOfflineCount()
Count of cluster offline events for this node.

Returns:
count

getCacheClusterRejoinCount

long getCacheClusterRejoinCount()
Count of cluster rejoin events for this node.

Returns:
count

getCacheClusterOnlineCount

long getCacheClusterOnlineCount()
Count of cluster online events for this node.

Returns:
count

getCacheName

String getCacheName()
Gets the cache name.

Returns:
the name of the Ehcache

getMaxGetTimeNanos

Long getMaxGetTimeNanos()
Return maximum time taken for a get operation in the cache in nanoseconds.

Returns:
maximum time taken for a get operation in the cache in nanoseconds

getMinGetTimeNanos

Long getMinGetTimeNanos()
Return minimum time taken for a get operation in the cache in nanoseconds.

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

getWriterQueueLength

long getWriterQueueLength()
Gets the size of the write-behind queue, if any. The value is for all local buckets

Returns:
Elements waiting to be processed by the write-behind writer.

getXaCommitCount

long getXaCommitCount()
Return the Cache's XAResource commit calls count.

Returns:
the Cache's XAResource commit calls count

getXaRollbackCount

long getXaRollbackCount()
Return the Cache's XAResource rollback calls count.

Returns:
the Cache's XAResource rollback calls count

getXaRecoveredCount

long getXaRecoveredCount()
Return the Cache's XAResource recovered XIDs count.

Returns:
the Cache's XAResource recovered XIDs count

getCacheHitMostRecentSample

long getCacheHitMostRecentSample()
Get most recent value for cache hit.

Returns:
Most recent sample for cache hit count

getCacheHitInMemoryMostRecentSample

long getCacheHitInMemoryMostRecentSample()
Get most recent value for in-memory cache hit.

Returns:
Most recent sample for cache hit count in memory

getCacheHitOffHeapMostRecentSample

long getCacheHitOffHeapMostRecentSample()
Get most recent value for off-heap cache hit.

Returns:
Most recent sample for cache hit count in off-heap

getCacheHitOnDiskMostRecentSample

long getCacheHitOnDiskMostRecentSample()
Get most recent value for on-disk cache hit.

Returns:
Most recent sample for cache hit count on disk

getCacheMissMostRecentSample

long getCacheMissMostRecentSample()
Get most recent value for cache miss.

Returns:
Most recent sample for cache miss count

getCacheMissInMemoryMostRecentSample

long getCacheMissInMemoryMostRecentSample()
Get most recent value for in-memory cache miss.

Returns:
Most recent sample for cache miss count in memory

getCacheMissOffHeapMostRecentSample

long getCacheMissOffHeapMostRecentSample()
Get most recent value for off-heap cache miss.

Returns:
Most recent sample for cache miss count in off-heap

getCacheMissOnDiskMostRecentSample

long getCacheMissOnDiskMostRecentSample()
Get most recent value for on-disk cache miss.

Returns:
Most recent sample for cache miss count on disk

getCacheMissExpiredMostRecentSample

long getCacheMissExpiredMostRecentSample()
Get most recent value for cache miss as result of the element getting expired.

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

getCacheMissNotFoundMostRecentSample

long getCacheMissNotFoundMostRecentSample()
Get most recent value for cache miss as result of the element not found in cache.

Returns:
Most recent sample for cache miss not found count

getCacheHitRatioMostRecentSample

int getCacheHitRatioMostRecentSample()
Get most recent value for cache hit ratio.

Returns:
Most recent value for cache hit ratio

getCacheElementEvictedMostRecentSample

long getCacheElementEvictedMostRecentSample()
Get most recent value element evicted from cache.

Returns:
Most recent sample for element evicted count

getCacheElementRemovedMostRecentSample

long getCacheElementRemovedMostRecentSample()
Get most recent value element removed from cache.

Returns:
Most recent sample for element removed count

getCacheElementExpiredMostRecentSample

long getCacheElementExpiredMostRecentSample()
Get most recent value element expired from cache.

Returns:
Most recent value for element expired count

getCacheElementPutMostRecentSample

long getCacheElementPutMostRecentSample()
Get most recent value element puts in the cache.

Returns:
Most recent sample for number of element puts

getCacheElementUpdatedMostRecentSample

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

Returns:
Most recent sampled value for element update count

getAverageGetTimeNanosMostRecentSample

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

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

dispose

void dispose()
Method used to dispose this statistics.


getAverageSearchTimeNanos

long getAverageSearchTimeNanos()
Get the average search execution time for searches finishing within the last sample period.

Returns:
the average search time nanos

getSearchesPerSecond

long getSearchesPerSecond()
Get the number of searches that have finished execution in the last second.

Returns:
the searches per second

getCacheXaCommitsMostRecentSample

long getCacheXaCommitsMostRecentSample()
Get most recent value of XA commits.

Returns:
the cache xa commits most recent sample

getCacheXaRollbacksMostRecentSample

long getCacheXaRollbacksMostRecentSample()
Get most recent value of XA rollbacks.

Returns:
the cache xa rollbacks most recent sample

isLocalHeapCountBased

boolean isLocalHeapCountBased()
Check if the local heap is measured with ARC or in element count.

Returns:
true, if is local heap count based

getCacheClusterOfflineMostRecentSample

long getCacheClusterOfflineMostRecentSample()
Gets the cache cluster offline most recent sample.

Returns:
the cache cluster offline most recent sample

getCacheClusterRejoinMostRecentSample

long getCacheClusterRejoinMostRecentSample()
Gets the cache cluster rejoin most recent sample.

Returns:
the cache cluster rejoin most recent sample

getCacheClusterOnlineMostRecentSample

long getCacheClusterOnlineMostRecentSample()
Gets the cache cluster online most recent sample.

Returns:
the cache cluster online most recent sample

getNonStopSuccessCount

long getNonStopSuccessCount()
Gets the non stop success count.

Returns:
the non stop success count

getNonStopFailureCount

long getNonStopFailureCount()
Gets the non stop failure count.

Returns:
the non stop failure count

getNonStopRejoinTimeoutCount

long getNonStopRejoinTimeoutCount()
Gets the non stop rejoin timeout count.

Returns:
the non stop rejoin timeout count

getNonStopTimeoutCount

long getNonStopTimeoutCount()
Gets the non stop timeout count.

Returns:
the non stop timeout count

getNonStopSuccessMostRecentSample

long getNonStopSuccessMostRecentSample()
Gets the non stop success most recent sample.

Returns:
the non stop success most recent sample

getNonStopFailureMostRecentSample

long getNonStopFailureMostRecentSample()
Gets the non stop failure most recent sample.

Returns:
the non stop failure most recent sample

getNonStopRejoinTimeoutMostRecentSample

long getNonStopRejoinTimeoutMostRecentSample()
Gets the non stop rejoin most recent sample.

Returns:
the non stop rejoin most recent sample

getNonStopTimeoutMostRecentSample

long getNonStopTimeoutMostRecentSample()
Gets the non stop timeout most recent sample.

Returns:
the non stop timeout most recent sample

ehcache

Copyright 2001-2014, Terracotta, Inc.