Package wt.cache
Interface ICacheManagerClassicMBean
- All Superinterfaces:
ICacheManagerMBean,ICacheManagerPlusMBean,SelfEmailingMBean
Instrumented cache management interface
Supported API: true
Extendable: true
Supported API: true
Extendable: true
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringType of notification produced when cache overflow exceeds specified thresholds, specifically when an overflowed entry has been in the cache less than ThrashingTimeThreshold seconds and the number of cache hits since the entry was last touched is less than ThrashingHitRatioThreshold * cache size
Supported API: truestatic final StringType of notification produced when cache is found to be oversized according to specified thresholds, specifically when PercentCacheTooOldLimit percent of cache entries are older than OversizedTimeThreshold seconds and the number of cache hits since the youngest entry considered too old was last touched is greater than OversizedHitRatioThreshold * cache size
Supported API: true -
Method Summary
Modifier and TypeMethodDescriptionvoidclear()Clears the cache.intAge-out threshold (in seconds) - entries older than this will be removed from the cache.doubleDeprecated.Property defining the size of the cache
Supported API: trueLogging level (valid values are ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF)
Supported API: trueLogger name for instrumented cache
Supported API: trueintDeprecated.intNumber of entries aged out of the cache because they were older than ageOutThreshold seconds
Supported API: trueintThreshold of cache hits to number of elements which must be exceeded to be considered oversized
Supported API: trueintThreshold for how old a cache entry can be before being considered too old (in seconds)
Supported API: truefloatPercentage of the cache that can be "too old" over which the cache is considered oversized
Supported API: trueintInterval between checks for thrashing condition in minutes
Supported API: trueintThreshold of cache hits to number of elements which must NOT be exceeded to be considered thrashing
Supported API: trueintThreshold for age of entries being overflown from the cache before being considered thrashing (in seconds)
Supported API: truebooleanWhether the age-out functionality is enabled
Supported API: truebooleanWhether to check for oversized cache condition on this ccache
Supported API: truebooleanWhether to check for thrashing condition
Supported API: truevoidRuns the oversized check on this cache once regardless of whether isCheckOversized is enabled
Supported API: truevoidSave cache configuration
Supported API: truevoidsetAgeOutThreshold(int ageOutThreshold) Age-out threshold (in seconds) - entries older than this will be removed from the cache.voidsetAveOverflowAgeThresholdSec(double value) Deprecated.voidsetCheckAgeOut(boolean checkAgeOut) Whether the age-out functionality is enabled
Supported API: truevoidsetCheckOversized(boolean checkOversized) Whether to check for oversized cache condition on this cache
Supported API: truevoidsetCheckThrashing(boolean checkThrashing) Whether to check for thrashing condition
Supported API: truevoidsetLoggerLevel(String level) logging level (valid values are ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF)
Supported API: truevoidsetMinMinutesBetweenNotifications(int value) Deprecated.voidsetOversizedHitRatioThreshold(int oversizedHitRatioThreshold) Threshold of cache hits to number of elements which must be exceeded to be considered oversized
Supported API: truevoidsetOversizedTimeThreshold(int oversizedTimeThreshold) Threshold for how old a cache entry can be before being considered too old (in seconds)
Supported API: truevoidsetPercentCacheTooOldLimit(float percentCacheTooOldLimit) Percentage of the cache that can be "too old" over which the cache is considered oversized
Supported API: truevoidsetThrashingCheckInterval(int thrashingCheckInterval) Interval between checks for thrashing condition in minutes
Supported API: truevoidsetThrashingHitRatioThreshold(int thrashingHitRatioThreshold) Threshold of cache hits to number of elements which must NOT be exceeded to be considered thrashing
Supported API: truevoidsetThrashingTimeThreshold(int thrashingTimeThreshold) Threshold for age of entries being overflown from the cache before being considered thrashing (in seconds)
Supported API: trueMethods inherited from interface wt.cache.ICacheManagerMBean
getCacheEntryCount, getCacheHits, getCacheMisses, getCacheOverflows, getCacheSize, getName, getRestartNumber, getUptime, logMethods inherited from interface wt.cache.ICacheManagerPlusMBean
getAverageEntryAgeInSecondsMethods inherited from interface wt.jmx.core.mbeans.SelfEmailingMBean
emailThisMBean
-
Field Details
-
OVERFLOW_ENTRY_YOUNGER_THAN_THRESHOLD
Type of notification produced when cache overflow exceeds specified thresholds, specifically when an overflowed entry has been in the cache less than ThrashingTimeThreshold seconds and the number of cache hits since the entry was last touched is less than ThrashingHitRatioThreshold * cache size
Supported API: true -
PERCENT_CACHE_OLDER_THAN_THRESHOLD
Type of notification produced when cache is found to be oversized according to specified thresholds, specifically when PercentCacheTooOldLimit percent of cache entries are older than OversizedTimeThreshold seconds and the number of cache hits since the youngest entry considered too old was last touched is greater than OversizedHitRatioThreshold * cache size
Supported API: true
-
-
Method Details
-
getAveOverflowAgeThresholdSec
double getAveOverflowAgeThresholdSec()Deprecated.Average overflow age threshold, in seconds, below which a notification will be emitted -
setAveOverflowAgeThresholdSec
Deprecated.Average overflow age threshold, in seconds, below which a notification will be emmited- Throws:
Exception
-
getMinMinutesBetweenNotifications
int getMinMinutesBetweenNotifications()Deprecated.Notification limit in minutes -
setMinMinutesBetweenNotifications
void setMinMinutesBetweenNotifications(int value) Deprecated.Notification limit in minutes -
getLoggerName
String getLoggerName()Logger name for instrumented cache
Supported API: true -
getLoggerLevel
String getLoggerLevel()Logging level (valid values are ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF)
Supported API: true -
setLoggerLevel
logging level (valid values are ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF)
Supported API: true -
getThrashingCheckInterval
int getThrashingCheckInterval()Interval between checks for thrashing condition in minutes
Supported API: true -
setThrashingCheckInterval
void setThrashingCheckInterval(int thrashingCheckInterval) Interval between checks for thrashing condition in minutes
Supported API: true -
getOversizedTimeThreshold
int getOversizedTimeThreshold()Threshold for how old a cache entry can be before being considered too old (in seconds)
Supported API: true -
setOversizedTimeThreshold
void setOversizedTimeThreshold(int oversizedTimeThreshold) Threshold for how old a cache entry can be before being considered too old (in seconds)
Supported API: true -
getThrashingTimeThreshold
int getThrashingTimeThreshold()Threshold for age of entries being overflown from the cache before being considered thrashing (in seconds)
Supported API: true -
setThrashingTimeThreshold
void setThrashingTimeThreshold(int thrashingTimeThreshold) Threshold for age of entries being overflown from the cache before being considered thrashing (in seconds)
Supported API: true -
getOversizedHitRatioThreshold
int getOversizedHitRatioThreshold()Threshold of cache hits to number of elements which must be exceeded to be considered oversized
Supported API: true -
setOversizedHitRatioThreshold
void setOversizedHitRatioThreshold(int oversizedHitRatioThreshold) Threshold of cache hits to number of elements which must be exceeded to be considered oversized
Supported API: true -
getThrashingHitRatioThreshold
int getThrashingHitRatioThreshold()Threshold of cache hits to number of elements which must NOT be exceeded to be considered thrashing
Supported API: true -
setThrashingHitRatioThreshold
void setThrashingHitRatioThreshold(int thrashingHitRatioThreshold) Threshold of cache hits to number of elements which must NOT be exceeded to be considered thrashing
Supported API: true -
isCheckOversized
boolean isCheckOversized()Whether to check for oversized cache condition on this ccache
Supported API: true -
setCheckOversized
void setCheckOversized(boolean checkOversized) Whether to check for oversized cache condition on this cache
Supported API: true -
isCheckThrashing
boolean isCheckThrashing()Whether to check for thrashing condition
Supported API: true -
setCheckThrashing
void setCheckThrashing(boolean checkThrashing) Whether to check for thrashing condition
Supported API: true -
getPercentCacheTooOldLimit
float getPercentCacheTooOldLimit()Percentage of the cache that can be "too old" over which the cache is considered oversized
Supported API: true -
setPercentCacheTooOldLimit
void setPercentCacheTooOldLimit(float percentCacheTooOldLimit) Percentage of the cache that can be "too old" over which the cache is considered oversized
Supported API: true -
saveCacheConfig
Save cache configuration
Supported API: true -
getCacheSizeProperty
String getCacheSizeProperty()Property defining the size of the cache
Supported API: true -
clear
Clears the cache. Waring: Clearing a cache in an in-use system may cause significant disruptions
Supported API: true -
getAgeOutThreshold
int getAgeOutThreshold()Age-out threshold (in seconds) - entries older than this will be removed from the cache.
Supported API: true -
setAgeOutThreshold
void setAgeOutThreshold(int ageOutThreshold) Age-out threshold (in seconds) - entries older than this will be removed from the cache.
Supported API: true -
isCheckAgeOut
boolean isCheckAgeOut()Whether the age-out functionality is enabled
Supported API: true -
setCheckAgeOut
void setCheckAgeOut(boolean checkAgeOut) Whether the age-out functionality is enabled
Supported API: true -
getNumEntriesAgedOut
int getNumEntriesAgedOut()Number of entries aged out of the cache because they were older than ageOutThreshold seconds
Supported API: true -
runOversizedCheck
Runs the oversized check on this cache once regardless of whether isCheckOversized is enabled
Supported API: true
-
getThrashingTimeThreshold()Supported API: true