Interface Stats

All Superinterfaces:
JsonSerialization
All Known Subinterfaces:
CacheContainerStats, ClusterCacheStats
All Known Implementing Classes:
CacheContainerStatsImpl, ClusterCacheStatsImpl, StatsCollector, StatsImpl

public interface Stats extends JsonSerialization
Stats.
Since:
4.0
Author:
Galder ZamarreƱo
  • Method Details

    • toJson

      default Json toJson()
      Specified by:
      toJson in interface JsonSerialization
    • getTimeSinceStart

      long getTimeSinceStart()
      Returns:
      Number of seconds since cache started.
    • getTimeSinceReset

      long getTimeSinceReset()
      Returns:
      Number of seconds since stats where reset
    • getApproximateEntries

      long getApproximateEntries()
      Returns the approximate number of entries in this cache that exist in memory or persistent storage. When the cache is configured with distribution, this method only returns the number of entries in the local cache instance. In other words, it does not communicate with other nodes to find out about data stored in the cluster and not available locally.
      Returns:
      Number of entries currently in the cache, including passivated entries.
    • getApproximateEntriesInMemory

      long getApproximateEntriesInMemory()
      The same as getApproximateEntries(), however passivated entries are not included.
    • getApproximateEntriesUnique

      long getApproximateEntriesUnique()
      The same as getApproximateEntries(), however only entries owned as primary are counted. This is only different from getApproximateEntries() only in distributed and replicated caches.
    • getCurrentNumberOfEntries

      @Deprecated(forRemoval=true, since="14.0") int getCurrentNumberOfEntries()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Since 14.0, please use getApproximateEntries() or getApproximateEntriesUnique() instead.
      Returns the number of entries currently in this cache instance. When the cache is configured with distribution, this method only returns the number of entries in the local cache instance. In other words, it does not attempt to communicate with other nodes to find out about the data stored in other nodes in the cluster that is not available locally.
      Returns:
      Number of entries currently in the cache, including passivated entries.
    • getCurrentNumberOfEntriesInMemory

      @Deprecated(forRemoval=true, since="14.0") int getCurrentNumberOfEntriesInMemory()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Since 14.0, please use getApproximateEntriesInMemory() instead.
      The same as getCurrentNumberOfEntries(), however passivated entries are not included.
    • getOffHeapMemoryUsed

      long getOffHeapMemoryUsed()
      The amount of off-heap memory used by this cache, or -1 if the cache stores data in the heap.
    • getDataMemoryUsed

      long getDataMemoryUsed()
      Provides how much memory the current eviction algorithm estimates is in use for data. This method will return a number 0 or greater if memory eviction is in use. If memory eviction is not enabled this method will always return -1.
      Returns:
      memory in use or -1 if memory eviction is not enabled
    • getStores

      long getStores()
      Returns:
      Number of entries stored in cache since start.
    • getRetrievals

      long getRetrievals()
      Returns:
      Number of entries read from the cache since start.
    • getHits

      long getHits()
      Returns:
      Number of cache get hits.
    • getMisses

      long getMisses()
      Returns:
      Number of cache get misses.
    • getRemoveHits

      long getRemoveHits()
      Returns:
      Number of cache removal hits.
    • getRemoveMisses

      long getRemoveMisses()
      Returns:
      Number of cache removal misses.
    • getEvictions

      long getEvictions()
      Returns:
      Number of cache eviction.
    • getAverageReadTime

      long getAverageReadTime()
      Returns:
      Average number of milliseconds for a cache get on the cache
    • getAverageReadTimeNanos

      long getAverageReadTimeNanos()
      Returns:
      Average number of nanoseconds for a cache get on the cache
    • getAverageWriteTime

      @Deprecated(forRemoval=true, since="14.0") long getAverageWriteTime()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Since 14.0, please use getAverageReadTimeNanos() instead.
      Returns:
      Average number of milliseconds for a cache put on the cache
    • getAverageWriteTimeNanos

      long getAverageWriteTimeNanos()
      Returns:
      Average number of milliseconds for a cache put on the cache
    • getAverageRemoveTime

      @Deprecated(forRemoval=true, since="14.0") long getAverageRemoveTime()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Since 14.0, please use getAverageWriteTimeNanos() instead.
      Returns:
      Average number of milliseconds for a cache remove on the cache
    • getAverageRemoveTimeNanos

      long getAverageRemoveTimeNanos()
      Returns:
      Average number of nanoseconds for a cache remove on the cache
    • getRequiredMinimumNumberOfNodes

      int getRequiredMinimumNumberOfNodes()
      Returns:
      Required minimum number of nodes to guarantee data consistency
    • reset

      void reset()
      Reset statistics
    • setStatisticsEnabled

      void setStatisticsEnabled(boolean enabled)
      Enables or disables statistics at runtime.
      Parameters:
      enabled - boolean indicating whether statistics should be enable or not