Package wt.cache

Interface ICacheManagerClassicMBean

All Superinterfaces:
ICacheManagerMBean, ICacheManagerPlusMBean, SelfEmailingMBean

public interface ICacheManagerClassicMBean extends ICacheManagerPlusMBean
Instrumented cache management interface

Supported API: true

Extendable: true
  • Field Details

    • OVERFLOW_ENTRY_YOUNGER_THAN_THRESHOLD

      static final String 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

      static final String 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.
      Replaced by getThrashingTimeThreshold()

      Supported API: true
      Average overflow age threshold, in seconds, below which a notification will be emitted
    • setAveOverflowAgeThresholdSec

      void setAveOverflowAgeThresholdSec(double value) throws Exception
      Deprecated.
      Replaced by setThrashingTimeThreshold(int)

      Supported API: true
      Average overflow age threshold, in seconds, below which a notification will be emmited
      Throws:
      Exception
    • getMinMinutesBetweenNotifications

      int getMinMinutesBetweenNotifications()
      Deprecated.
      Replaced by getThrashingCheckInterval()

      Supported API: true
      Notification limit in minutes
    • setMinMinutesBetweenNotifications

      void setMinMinutesBetweenNotifications(int value)
      Deprecated.
      Replaced by setThrashingCheckInterval(int)

      Supported API: true
      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

      void setLoggerLevel(String level)
      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

      @MBeanOperationImpact(1) void saveCacheConfig()
      Save cache configuration

      Supported API: true
    • getCacheSizeProperty

      String getCacheSizeProperty()
      Property defining the size of the cache

      Supported API: true
    • clear

      @MBeanOperationImpact(1) void 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

      @MBeanOperationImpact(1) void runOversizedCheck()
      Runs the oversized check on this cache once regardless of whether isCheckOversized is enabled

      Supported API: true