public class CacheStatistics extends Object implements CacheStatisticsMBean, Serializable
Cache.setStatisticsAccuracy(int).
Because this class maintains a reference to an Ehcache, any references held to this class will precent the Ehcache
from getting garbage collected.| Constructor and Description |
|---|
CacheStatistics(Ehcache ehcache)
Constructs an object from an ehcache statistics object using the default statistics ttl.
|
CacheStatistics(Ehcache ehcache,
long ttl,
TimeUnit unit)
Constructs an object from an ehcache statistics object
|
| Modifier and Type | Method and Description |
|---|---|
void |
clearStatistics()
Clears the statistic counters to 0 for the associated Cache.
|
String |
getAssociatedCacheName() |
double |
getCacheHitPercentage()
Returns the percentage of cache accesses that found a requested item in the cache.
|
long |
getCacheHits()
The number of times a requested item was found in the cache.
|
long |
getCacheMisses()
Warning.
|
double |
getCacheMissPercentage()
Returns the percentage of cache accesses that did not find a requested element in the cache.
|
long |
getDiskStoreObjectCount()
Gets the number of objects in the DiskStore
|
Ehcache |
getEhcache()
Return the backing cache.
|
double |
getInMemoryHitPercentage()
Returns the percentage of cache accesses that found a requested item cached in-memory.
|
long |
getInMemoryHits()
Number of times a requested item was found in the Memory Store.
|
long |
getInMemoryMisses() |
long |
getMemoryStoreObjectCount()
Gets the number of objects in the MemoryStore
|
long |
getObjectCount()
Gets the number of elements stored in the cache.
|
double |
getOffHeapHitPercentage()
Returns the percentage of cache accesses that found a requested item cached off-heap.
|
long |
getOffHeapHits()
Number of times a requested item was found in the off-heap store.
|
long |
getOffHeapMisses() |
long |
getOffHeapStoreObjectCount()
Gets the number of objects in the OffHeapStore
|
double |
getOnDiskHitPercentage()
Returns the percentage of cache accesses that found a requested item cached on disk.
|
long |
getOnDiskHits()
Number of times a requested item was found in the Disk Store.
|
long |
getOnDiskMisses() |
int |
getStatisticsAccuracy()
Accurately measuring statistics can be expensive.
|
String |
getStatisticsAccuracyDescription()
Accurately measuring statistics can be expensive.
|
int |
getWriterMaxQueueSize()
Gets the maximum size of the write-behind queue, if any.
|
long |
getWriterQueueLength()
Gets the size of the write-behind queue, if any.
|
public CacheStatistics(Ehcache ehcache, long ttl, TimeUnit unit)
ehcache - the backing ehcachettl - statistics ttl valueunit - statistics ttl unitpublic CacheStatistics(Ehcache ehcache)
ehcache - the backing ehcachepublic int getStatisticsAccuracy()
getStatisticsAccuracy in interface CacheStatisticsMBeanStatistics.STATISTICS_ACCURACY_BEST_EFFORT, Statistics.STATISTICS_ACCURACY_GUARANTEED, Statistics.STATISTICS_ACCURACY_NONEpublic String getStatisticsAccuracyDescription()
getStatisticsAccuracyDescription in interface CacheStatisticsMBeanpublic String getAssociatedCacheName()
getAssociatedCacheName in interface CacheStatisticsMBeanpublic void clearStatistics()
clearStatistics in interface CacheStatisticsMBeanpublic long getCacheHits()
getCacheHits in interface CacheStatisticsMBeanpublic long getInMemoryHits()
getInMemoryHits in interface CacheStatisticsMBeanpublic long getOffHeapHits()
getOffHeapHits in interface CacheStatisticsMBeanpublic long getOnDiskHits()
getOnDiskHits in interface CacheStatisticsMBeanpublic long getCacheMisses()
getCacheMisses in interface CacheStatisticsMBeanpublic long getInMemoryMisses()
getInMemoryMisses in interface CacheStatisticsMBeanpublic long getOffHeapMisses()
getOffHeapMisses in interface CacheStatisticsMBeanpublic long getOnDiskMisses()
getOnDiskMisses in interface CacheStatisticsMBeanpublic long getObjectCount()
Statistics.STATISTICS_ACCURACY_BEST_EFFORT.
The size is the number of Elements in the MemoryStore plus
the number of Elements in the DiskStore.
This number is the actual number of elements, including expired elements that have
not been removed. Any duplicates between stores are accounted for.
Expired elements are removed from the the memory store when
getting an expired element, or when attempting to spool an expired element to
disk.
Expired elements are removed from the disk store when getting an expired element,
or when the expiry thread runs, which is once every five minutes.
Statistics.STATISTICS_ACCURACY_GUARANTEED.
This method accounts for elements which might be expired or duplicated between stores. It take approximately
200ms per 1000 elements to execute.
Statistics.STATISTICS_ACCURACY_NONE.
The number given may contain expired elements. In addition if the DiskStore is used it may contain some double
counting of elements. It takes 6ms for 1000 elements to execute. Time to execute is O(log n). 50,000 elements take
36ms.getObjectCount in interface CacheStatisticsMBeanpublic long getWriterQueueLength()
getWriterQueueLength in interface CacheStatisticsMBeanpublic int getWriterMaxQueueSize()
getWriterMaxQueueSize in interface CacheStatisticsMBeanpublic long getMemoryStoreObjectCount()
getMemoryStoreObjectCount in interface CacheStatisticsMBeanpublic long getOffHeapStoreObjectCount()
getOffHeapStoreObjectCount in interface CacheStatisticsMBeanpublic long getDiskStoreObjectCount()
getDiskStoreObjectCount in interface CacheStatisticsMBeanpublic Ehcache getEhcache()
public double getCacheHitPercentage()
getCacheHitPercentage in interface CacheStatisticsMBeanpublic double getCacheMissPercentage()
getCacheMissPercentage in interface CacheStatisticsMBeanpublic double getInMemoryHitPercentage()
getInMemoryHitPercentage in interface CacheStatisticsMBeanpublic double getOffHeapHitPercentage()
getOffHeapHitPercentage in interface CacheStatisticsMBeanpublic double getOnDiskHitPercentage()
getOnDiskHitPercentage in interface CacheStatisticsMBeanCopyright © 2003-2014 Terracotta, Inc.. All Rights Reserved.