public class PersistentCacheStats extends AnnotatedStandardMBean implements PersistentCacheStatsMBean
TYPE
Constructor and Description |
---|
PersistentCacheStats(CacheType cacheType,
StatisticsProvider provider) |
Modifier and Type | Method and Description |
---|---|
void |
addWriteGeneration(int generation) |
java.lang.String |
cacheInfoAsString()
Gathers the stats of the cache for logging.
|
long |
estimateCurrentWeight()
Total weight of the complete cache.
|
double |
getAverageLoadPenalty()
Returns the average time spent loading new values.
|
javax.management.openmbean.CompositeData |
getBroadcastRecvRateHistory() |
long |
getElementCount()
Get the number of elements/objects in the cache.
|
long |
getEvictionCount()
Returns the number of times an entry has been evicted.
|
long |
getHitCount()
Returns the number of times
com.google.common.cache.Cache lookup methods have returned a cached value. |
javax.management.openmbean.CompositeData |
getHitPercentageHistory() |
double |
getHitRate()
Returns the ratio of cache requests which were hits.
|
javax.management.openmbean.CompositeData |
getHitRateHistory() |
javax.management.openmbean.CompositeData |
getInvalidateAllRateHistory() |
javax.management.openmbean.CompositeData |
getInvalidateOneRateHistory() |
long |
getLoadCount()
Returns the total number of times that
com.google.common.cache.Cache lookup methods attempted to load new
values. |
long |
getLoadExceptionCount()
Returns the number of times
com.google.common.cache.Cache lookup methods threw an exception while loading a
new value. |
double |
getLoadExceptionRate()
Returns the ratio of cache loading attempts which threw exceptions.
|
javax.management.openmbean.CompositeData |
getLoadExceptionRateHistory() |
javax.management.openmbean.CompositeData |
getLoadRateHistory() |
long |
getLoadSuccessCount()
Returns the number of times
com.google.common.cache.Cache lookup methods have successfully loaded a new value. |
long |
getMaxTotalWeight()
The maximum weight of entries the cache may contain.
|
long |
getMissCount()
Returns the number of times
com.google.common.cache.Cache lookup methods have returned an uncached (newly
loaded) value, or null. |
double |
getMissRate()
Returns the ratio of cache requests which were misses.
|
java.lang.String |
getName() |
javax.management.openmbean.CompositeData |
getPutRateHistory() |
javax.management.openmbean.CompositeData |
getPutRejectedAlreadyPersistedRateHistory() |
javax.management.openmbean.CompositeData |
getPutRejectedAsCachedInSecRateHistory() |
javax.management.openmbean.CompositeData |
getPutRejectedEntryNotUsedRateHistory() |
javax.management.openmbean.CompositeData |
getPutRejectedQueueFullRateHistory() |
long |
getRequestCount()
Returns the number of times
com.google.common.cache.Cache lookup methods have returned either a cached or
uncached value. |
javax.management.openmbean.CompositeData |
getRequestRateHistory() |
long |
getTotalLoadTime()
Returns the total number of nanoseconds the cache has spent loading new values.
|
javax.management.openmbean.CompositeData |
getUsedSpaceHistory() |
void |
markBytesWritten(long numBytes) |
void |
markException() |
void |
markHit() |
void |
markInvalidateAll() |
void |
markInvalidateOne() |
void |
markPut() |
void |
markPutRejectedAlreadyPersisted() |
void |
markPutRejectedAsCachedInSecondary() |
void |
markPutRejectedEntryNotUsed() |
void |
markPutRejectedQueueFull() |
void |
markRecvBroadcast() |
void |
markRequest() |
void |
removeReadGeneration(int generation) |
void |
resetStats()
Reset the cache stats
|
TimerStats.Context |
startLoaderTimer() |
TimerStats.Context |
startReadTimer() |
getDescription, getDescription, getDescription, getDescription, getImpact, getParameterName
cacheMBeanInfo, getAttribute, getAttributes, getCachedMBeanInfo, getClassName, getConstructors, getDescription, getDescription, getDescription, getImplementation, getImplementationClass, getMBeanInfo, getMBeanInterface, getParameterName, invoke, postDeregister, postRegister, preDeregister, preRegister, setAttribute, setAttributes, setImplementation
public PersistentCacheStats(CacheType cacheType, StatisticsProvider provider)
public void markHit()
public void markRequest()
public void markException()
public void markPut()
public void markRecvBroadcast()
public void markInvalidateOne()
public void markInvalidateAll()
public void markPutRejectedAlreadyPersisted()
public void markPutRejectedEntryNotUsed()
public void markPutRejectedAsCachedInSecondary()
public void markPutRejectedQueueFull()
public TimerStats.Context startReadTimer()
public TimerStats.Context startLoaderTimer()
public void addWriteGeneration(int generation)
public void removeReadGeneration(int generation)
public void markBytesWritten(long numBytes)
public java.lang.String getName()
getName
in interface CacheStatsMBean
public long getRequestCount()
CacheStatsMBean
com.google.common.cache.Cache
lookup methods have returned either a cached or
uncached value. This is defined as getHitCount + getMissCount
.getRequestCount
in interface CacheStatsMBean
public long getHitCount()
CacheStatsMBean
com.google.common.cache.Cache
lookup methods have returned a cached value.getHitCount
in interface CacheStatsMBean
public double getHitRate()
CacheStatsMBean
getHitCount / getRequestCount
, or 1.0
when getRequestCount == 0
.
Note that getHitRate + getMissRate =~ 1.0
.getHitRate
in interface CacheStatsMBean
public long getMissCount()
CacheStatsMBean
com.google.common.cache.Cache
lookup methods have returned an uncached (newly
loaded) value, or null. Multiple concurrent calls to com.google.common.cache.Cache
lookup methods on an absent
value can result in multiple misses, all returning the results of a single cache load
operation.getMissCount
in interface CacheStatsMBean
public double getMissRate()
CacheStatsMBean
getMissCount / getRequestCount
, or 0.0
when getRequestCount == 0
.
Note that getHitRate + getMissRate =~ 1.0
. Cache misses include all requests which
weren't cache hits, including requests which resulted in either successful or failed loading
attempts, and requests which waited for other threads to finish loading. It is thus the case
that getMissCount >= getLoadSuccessCount + getLoadExceptionCount
. Multiple
concurrent misses for the same key will result in a single load operation.getMissRate
in interface CacheStatsMBean
public long getLoadCount()
CacheStatsMBean
com.google.common.cache.Cache
lookup methods attempted to load new
values. This includes both successful load operations, as well as those that threw
exceptions. This is defined as getLoadSuccessCount + getLoadExceptionCount
.getLoadCount
in interface CacheStatsMBean
public long getLoadSuccessCount()
CacheStatsMBean
com.google.common.cache.Cache
lookup methods have successfully loaded a new value.
This is always incremented in conjunction with CacheStatsMBean.getMissCount()
, though getMissCount
is also incremented when an exception is encountered during cache loading (see
CacheStatsMBean.getLoadExceptionCount()
). Multiple concurrent misses for the same key will result in a
single load operation.getLoadSuccessCount
in interface CacheStatsMBean
public long getLoadExceptionCount()
CacheStatsMBean
com.google.common.cache.Cache
lookup methods threw an exception while loading a
new value. This is always incremented in conjunction with getMissCount
, though
getMissCount
is also incremented when cache loading completes successfully (see
CacheStatsMBean.getLoadSuccessCount()
). Multiple concurrent misses for the same key will result in a
single load operation.getLoadExceptionCount
in interface CacheStatsMBean
public double getLoadExceptionRate()
CacheStatsMBean
getLoadExceptionCount / (getLoadSuccessCount + getLoadExceptionCount)
, or
0.0
when getLoadSuccessCount + getLoadExceptionCount == 0
.getLoadExceptionRate
in interface CacheStatsMBean
public long estimateCurrentWeight()
CacheStatsMBean
estimateCurrentWeight
in interface CacheStatsMBean
public javax.management.openmbean.CompositeData getRequestRateHistory()
getRequestRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getHitRateHistory()
getHitRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getLoadRateHistory()
getLoadRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getLoadExceptionRateHistory()
getLoadExceptionRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getHitPercentageHistory()
getHitPercentageHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getPutRateHistory()
getPutRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getPutRejectedAlreadyPersistedRateHistory()
getPutRejectedAlreadyPersistedRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getPutRejectedEntryNotUsedRateHistory()
getPutRejectedEntryNotUsedRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getPutRejectedQueueFullRateHistory()
getPutRejectedQueueFullRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getPutRejectedAsCachedInSecRateHistory()
getPutRejectedAsCachedInSecRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getInvalidateOneRateHistory()
getInvalidateOneRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getInvalidateAllRateHistory()
getInvalidateAllRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getBroadcastRecvRateHistory()
getBroadcastRecvRateHistory
in interface PersistentCacheStatsMBean
public javax.management.openmbean.CompositeData getUsedSpaceHistory()
getUsedSpaceHistory
in interface PersistentCacheStatsMBean
public java.lang.String cacheInfoAsString()
CacheStatsMBean
cacheInfoAsString
in interface CacheStatsMBean
cacheInfoAsString
in interface PersistentCacheStatsMBean
public long getTotalLoadTime()
CacheStatsMBean
getLoadSuccessCount
or getLoadExceptionCount
is incremented.getTotalLoadTime
in interface CacheStatsMBean
public double getAverageLoadPenalty()
CacheStatsMBean
getTotalLoadTime / (getLoadSuccessCount + getLoadExceptionCount)
.getAverageLoadPenalty
in interface CacheStatsMBean
public long getEvictionCount()
CacheStatsMBean
com.google.common.cache.Cache#invalidate invalidations
.getEvictionCount
in interface CacheStatsMBean
public long getElementCount()
CacheStatsMBean
getElementCount
in interface CacheStatsMBean
public long getMaxTotalWeight()
CacheStatsMBean
getMaxTotalWeight
in interface CacheStatsMBean
public void resetStats()
CacheStatsMBean
resetStats
in interface CacheStatsMBean
Copyright © 2012–2022 The Apache Software Foundation. All rights reserved.