Interface ICacheStatistics

An interface for exposing ICache statistics.

Namespace: Tangosol.Net.Cache

Assembly: Coherence.dll

Syntax

public interface ICacheStatistics

Properties

AverageGetMillis

Determine the average number of milliseconds per "get" invocation since the cache statistics were last reset.

Declaration

double AverageGetMillis { get; }

Property Value

Type	Description
double	The average number of milliseconds per "get" operation.

AverageHitMillis

Determine the average number of milliseconds per "get" invocation that is a hit.

Declaration

double AverageHitMillis { get; }

Property Value

Type	Description
double	The average number of milliseconds per cache hit.

AverageMissMillis

Determine the average number of milliseconds per "get" invocation that is a miss.

Declaration

double AverageMissMillis { get; }

Property Value

Type	Description
double	The average number of milliseconds per cache miss.

AveragePruneMillis

Determine the average number of milliseconds per cache pruning.

Declaration

double AveragePruneMillis { get; }

Property Value

Type	Description
double	The average number of milliseconds per cache pruning.

AveragePutMillis

Determine the average number of milliseconds per "put" invocation since the cache statistics were last reset.

Declaration

double AveragePutMillis { get; }

Property Value

Type	Description
double	The average number of milliseconds per "put" operation.

CacheHits

Determine the rough number of cache hits since the cache statistics were last reset.

Declaration

long CacheHits { get; }

Property Value

Type	Description
long	The number of "get" calls that have been served by existing cache entries.

Remarks

A cache hit is a read operation invocation (i.e. "get") for which an entry exists in this cache.

CacheHitsMillis

Determine the total number of milliseconds (since that last statistics reset) for the "get" operations for which an entry existed in this cache.

Declaration

long CacheHitsMillis { get; }

Property Value

Type	Description
long	The total number of milliseconds for the "get" operations that were hits.

CacheMisses

Determine the rough number of cache misses since the cache statistics were last reset.

Declaration

long CacheMisses { get; }

Property Value

Type	Description
long	The number of "get" calls that failed to find an existing cache entry because the requested key was not in the cache.

Remarks

A cache miss is a "get" invocation that does not have an entry in this cache.

CacheMissesMillis

Determine the total number of milliseconds (since that last statistics reset) for the "get" operations for which no entry existed in this cache.

Declaration

long CacheMissesMillis { get; }

Property Value

Type	Description
long	The total number of milliseconds (since that last statistics reset) for the "get" operations that were misses.

CachePrunes

Determine the rough number of cache pruning cycles since the cache statistics were last reset.

Declaration

long CachePrunes { get; }

Property Value

Type	Description
long	The total number of cache pruning cycles (since that last statistics reset).

Remarks

For the LocalCache implementation, this refers to the number of times that the prune() method is executed.

CachePrunesMillis

Determine the total number of milliseconds (since that last statistics reset) spent on cache pruning.

Declaration

long CachePrunesMillis { get; }

Property Value

Type	Description
long	The total number of milliseconds (since that last statistics reset) for cache pruning operations.

Remarks

For the LocalCache implementation, this refers to the time spent in the prune() method.

HitProbability

Determine the rough probability (0 <= p <= 1) that the next invocation will be a hit, based on the statistics collected since the last reset of the cache statistics.

Declaration

double HitProbability { get; }

Property Value

Type	Description
double	The cache hit probability (0 <= p <= 1).

TotalGets

Determine the total number of "get" operations since the cache statistics were last reset.

Declaration

long TotalGets { get; }

Property Value

Type	Description
long	The total number of "get" operations.

TotalGetsMillis

Determine the total number of milliseconds spent on "get" operations since the cache statistics were last reset.

Declaration

long TotalGetsMillis { get; }

Property Value

Type	Description
long	The total number of milliseconds processing "get" operations.

TotalPuts

Determine the total number of "put" operations since the cache statistics were last reset.

Declaration

long TotalPuts { get; }

Property Value

Type	Description
long	The total number of "put" operations.

TotalPutsMillis

Determine the total number of milliseconds spent on "put" operations since the cache statistics were last reset.

Declaration

long TotalPutsMillis { get; }

Property Value

Type	Description
long	The total number of milliseconds processing "put" operations.

Methods

ResetHitStatistics()

Reset the cache statistics.

Declaration

void ResetHitStatistics()