Package org.alfresco.repo.cache

Interface CacheStatistics

  • All Known Implementing Classes:
    InMemoryCacheStatistics
    public interface CacheStatistics
    Centralised cache statistics service. Transactional caches participating in statistical collection will provide their data to this service using the add(String, TransactionStats) method. The data is then aggregated so that, for example, the hit ratio for a particular cache may be retrieved.
    Since:
    5.0
    Author:
    Matt Ward

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void add​(java.lang.String cacheName, TransactionStats stats)
      Add new details to the system wide cache statistics.
      java.util.Map<TransactionStats.OpType,​OperationStats> allStats​(java.lang.String cacheName)
      Retrieve a map containing a snapshot of all of the raw stats (e.g.
      long count​(java.lang.String cacheName, TransactionStats.OpType opType)
      Get the number of occurrences of the given operation type, retrieve the number of cache hits that have happened to the cache.
      double hitMissRatio​(java.lang.String cacheName)
      The hit ratio for the given cache, where 1.0 is the maximum possible value and 0.0 represents a cache that has never successfully returned a previously cached value.
      double meanTime​(java.lang.String cacheName, TransactionStats.OpType opType)
      The mean time in nanoseconds for all operations of the given type.
      long numGets​(java.lang.String cacheName)
      Retrieve the total number of get operations invoked on the cache (i.e.

    • Method Detail

      • add

        void add​(java.lang.String cacheName,
         TransactionStats stats)
        Add new details to the system wide cache statistics.

      • count

        long count​(java.lang.String cacheName,
           TransactionStats.OpType opType)
        Get the number of occurrences of the given operation type, retrieve the number of cache hits that have happened to the cache.
        Parameters:
        cacheName - Name of the cache.
        opType - Type of cache operation.
        Returns:
        long count

      • meanTime

        double meanTime​(java.lang.String cacheName,
                TransactionStats.OpType opType)
        The mean time in nanoseconds for all operations of the given type.
        Parameters:
        cacheName - The cache name.
        opType - Type of operation, e.g. cache hits.
        Returns:
        Time in nanos (double) or NaN if not available yet.

      • hitMissRatio

        double hitMissRatio​(java.lang.String cacheName)
        The hit ratio for the given cache, where 1.0 is the maximum possible value and 0.0 represents a cache that has never successfully returned a previously cached value.
        Parameters:
        cacheName - The cache name.
        Returns:
        ratio (double)

      • numGets

        long numGets​(java.lang.String cacheName)
        Retrieve the total number of get operations invoked on the cache (i.e. sum of hits and misses).
        Parameters:
        cacheName - The cache name.
        Returns:
        Count of get operations.

      • allStats

        java.util.Map<TransactionStats.OpType,​OperationStats> allStats​(java.lang.String cacheName)
        Retrieve a map containing a snapshot of all of the raw stats (e.g. counts, mean operation times etc.). Since this is a snapshot it is unaffected by future modifications to the statistics - by using add(String, TransactionStats) for example.
        Parameters:
        cacheName - The cache name.
        Returns:
        Map of OpType to OperationStats