net.sf.ehcache.Statistics Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ehcache-core Show documentation
Show all versions of ehcache-core Show documentation
This is the ehcache core module. Pair it with other modules for added functionality.
/**
* Copyright 2003-2010 Terracotta, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.sf.ehcache;
import java.io.Serializable;
/**
* An immutable Cache statistics implementation
*
* This is like a value object, with the added ability to clear cache statistics on the cache.
* That ability does not survive any Serialization of this class. On deserialization the cache
* can be considered disconnected.
*
* The accuracy of these statistics are determined by the value of {@link Cache#getStatisticsAccuracy()}
* at the time the statistic was computed. This can be changed by setting {@link Cache#setStatisticsAccuracy}.
*
* Because this class maintains a reference to an Ehcache, any references held to this class will prevent the Ehcache
* from getting garbage collected.
*
* todo Add missCountExpired. Request from user.
*
* @author Greg Luck
* @version $Id: Statistics.java 4280 2011-07-04 13:31:39Z alexsnaps $
*/
public class Statistics implements Serializable {
/**
* Fast but not accurate setting.
*/
public static final int STATISTICS_ACCURACY_NONE = 0;
/**
* Best efforts accuracy setting.
*/
public static final int STATISTICS_ACCURACY_BEST_EFFORT = 1;
/**
* Guaranteed accuracy setting.
*/
public static final int STATISTICS_ACCURACY_GUARANTEED = 2;
private static final long serialVersionUID = 3606940454221918725L;
private transient Ehcache cache;
private final String cacheName;
private final int statisticsAccuracy;
private final long cacheHits;
private final long onDiskHits;
private final long offHeapHits;
private final long inMemoryHits;
private final long misses;
private final long onDiskMisses;
private final long offHeapMisses;
private final long inMemoryMisses;
private final long size;
private final long memoryStoreSize;
private final long offHeapStoreSize;
private final long diskStoreSize;
private final float averageGetTime;
private final long evictionCount;
private final long searchesPerSecond;
private final long averageSearchTime;
private long writerQueueLength;
/**
* Creates a new statistics object, associated with a Cache
*
* @param cache The cache that {@link #clearStatistics()} will call, if not disconnected
* @param statisticsAccuracy
* @param cacheHits
* @param onDiskHits
* @param offHeapHits
* @param inMemoryHits
* @param misses
* @param size
*/
public Statistics(Ehcache cache, int statisticsAccuracy, long cacheHits, long onDiskHits, long offHeapHits,
long inMemoryHits, long misses, long onDiskMisses, long offHeapMisses,
long inMemoryMisses, long size, float averageGetTime, long evictionCount,
long memoryStoreSize, long offHeapStoreSize, long diskStoreSize, long searchesPerSecond,
long averageSearchTime, long writerQueueLength) {
this.cacheName = cache.getName();
this.statisticsAccuracy = statisticsAccuracy;
this.cacheHits = cacheHits;
this.onDiskHits = onDiskHits;
this.offHeapHits = offHeapHits;
this.inMemoryHits = inMemoryHits;
this.misses = misses;
this.onDiskMisses = onDiskMisses;
this.offHeapMisses = offHeapMisses;
this.inMemoryMisses = inMemoryMisses;
this.cache = cache;
this.size = size;
this.averageGetTime = averageGetTime;
this.evictionCount = evictionCount;
this.memoryStoreSize = memoryStoreSize;
this.offHeapStoreSize = offHeapStoreSize;
this.diskStoreSize = diskStoreSize;
this.searchesPerSecond = searchesPerSecond;
this.averageSearchTime = averageSearchTime;
this.writerQueueLength = writerQueueLength;
}
/**
* Clears the statistic counters to 0 for the associated Cache.
*/
public void clearStatistics() {
if (cache == null) {
throw new IllegalStateException("This statistics object no longer references a Cache.");
}
cache.clearStatistics();
}
/**
* The number of times a requested item was found in the cache.
*
* @return the number of times a requested item was found in the cache
*/
public long getCacheHits() {
return cacheHits;
}
/**
* Number of times a requested item was found in the Memory Store.
*
* @return the number of times a requested item was found in memory
*/
public long getInMemoryHits() {
return inMemoryHits;
}
/**
* Number of times a requested item was found in the off-heap store.
*
* @return the number of times a requested item was found in off-heap
*/
public long getOffHeapHits() {
return offHeapHits;
}
/**
* Number of times a requested item was found in the Disk Store.
*
* @return the number of times a requested item was found on Disk, or 0 if there is no disk storage configured.
*/
public long getOnDiskHits() {
return onDiskHits;
}
/**
* @return the number of times a requested element was not found in the cache
*/
public long getCacheMisses() {
return misses;
}
/**
* Number of times a requested item was not found in the Memory Store.
*
* @return the number of times a requested item was not found in memory
*/
public long getInMemoryMisses() {
return inMemoryMisses;
}
/**
* Number of times a requested item was not found in the off-heap store.
*
* @return the number of times a requested item was not found in off-heap
*/
public long getOffHeapMisses() {
return offHeapMisses;
}
/**
* Number of times a requested item was not found in the Disk Store.
*
* @return the number of times a requested item was not found on Disk, or 0 if there is no disk storage configured.
*/
public long getOnDiskMisses() {
return onDiskMisses;
}
/**
* Gets the number of elements stored in the cache. Caclulating this can be expensive. Accordingly,
* this method will return three different values, depending on the statistics accuracy setting.
* Best Effort Size
* This result is returned when the statistics accuracy setting is {@link Statistics#STATISTICS_ACCURACY_BEST_EFFORT}.
*
* The size is the number of {@link Element}s in the {@link net.sf.ehcache.store.MemoryStore} plus
* the number of {@link Element}s in the {@link net.sf.ehcache.store.disk.DiskStore}.
*
* This number is the actual number of elements, including expired elements that have
* not been removed. Any duplicates between stores are accounted for.
*
* Expired elements are removed from the the memory store when
* getting an expired element, or when attempting to spool an expired element to
* disk.
*
* Expired elements are removed from the disk store when getting an expired element,
* or when the expiry thread runs, which is once every five minutes.
*
* Guaranteed Accuracy Size
* This result is returned when the statistics accuracy setting is {@link Statistics#STATISTICS_ACCURACY_GUARANTEED}.
*
* This method accounts for elements which might be expired or duplicated between stores. It take approximately
* 200ms per 1000 elements to execute.
* Fast but non-accurate Size
* This result is returned when the statistics accuracy setting is {@link #STATISTICS_ACCURACY_NONE}.
*
* The number given may contain expired elements. In addition if the DiskStore is used it may contain some double
* counting of elements. It takes 6ms for 1000 elements to execute. Time to execute is O(log n). 50,000 elements take
* 36ms.
*
* @return the number of elements in the ehcache, with a varying degree of accuracy, depending on accuracy setting.
*/
public long getObjectCount() {
return size;
}
/**
*
* @return the number of objects in the memory store
*/
public long getMemoryStoreObjectCount() {
return memoryStoreSize;
}
/**
*
* @return the number of objects in the off-heap store
*/
public long getOffHeapStoreObjectCount() {
return offHeapStoreSize;
}
/**
*
* @return the number of objects in the disk store
*/
public long getDiskStoreObjectCount() {
return diskStoreSize;
}
/**
* Accurately measuring statistics can be expensive. Returns the current accuracy setting.
*
* @return one of {@link #STATISTICS_ACCURACY_BEST_EFFORT}, {@link #STATISTICS_ACCURACY_GUARANTEED}, {@link #STATISTICS_ACCURACY_NONE}
*/
public int getStatisticsAccuracy() {
return statisticsAccuracy;
}
/**
* Accurately measuring statistics can be expensive. Returns the current accuracy setting.
*
* @return a human readable description of the accuracy setting. One of "None", "Best Effort" or "Guaranteed".
*/
public String getStatisticsAccuracyDescription() {
if (statisticsAccuracy == 0) {
return "None";
} else if (statisticsAccuracy == 1) {
return "Best Effort";
} else {
return "Guaranteed";
}
}
/**
* @return the name of the Ehcache, or null if a reference is no longer held to the cache,
* as, it would be after deserialization.
*/
public String getAssociatedCacheName() {
if (cache != null) {
return cache.getName();
} else {
return cacheName;
}
}
/**
* @return the name of the Ehcache, or null if a reference is no longer held to the cache,
* as, it would be after deserialization.
*/
public Ehcache getAssociatedCache() {
if (cache != null) {
return cache;
} else {
return null;
}
}
/**
* Returns a {@link String} representation of the {@link Ehcache} statistics.
*/
@Override
public final String toString() {
StringBuilder dump = new StringBuilder();
dump.append("[ ")
.append(" name = ").append(getAssociatedCacheName())
.append(" cacheHits = ").append(cacheHits)
.append(" onDiskHits = ").append(onDiskHits)
.append(" offHeapHits = ").append(offHeapHits)
.append(" inMemoryHits = ").append(inMemoryHits)
.append(" misses = ").append(misses)
.append(" onDiskMisses = ").append(onDiskMisses)
.append(" offHeapMisses = ").append(offHeapMisses)
.append(" inMemoryMisses = ").append(inMemoryMisses)
.append(" size = ").append(size)
.append(" averageGetTime = ").append(averageGetTime)
.append(" evictionCount = ").append(evictionCount)
.append(" ]");
return dump.toString();
}
/**
* The average get time. Because ehcache support JDK1.4.2, each get time uses
* System.currentTimeMilis, rather than nanoseconds. The accuracy is thus limited.
*/
public float getAverageGetTime() {
return averageGetTime;
}
/**
* Gets the number of cache evictions, since the cache was created, or statistics were cleared.
*/
public long getEvictionCount() {
return evictionCount;
}
/**
* Gets the average execution time (in milliseconds) within the last sample period
*/
public long getAverageSearchTime() {
return averageSearchTime;
}
/**
* Get the number of search executions that have completed in the last second
*/
public long getSearchesPerSecond() {
return searchesPerSecond;
}
/**
* Utility method to determine if a given value is a valid statistics
* accuracy value or not
*
* @param statisticsAccuracy
* @return true if the value is one of
* {@link Statistics#STATISTICS_ACCURACY_BEST_EFFORT},
* {@link Statistics#STATISTICS_ACCURACY_GUARANTEED},
* {@link Statistics#STATISTICS_ACCURACY_NONE}
*/
public static boolean isValidStatisticsAccuracy(int statisticsAccuracy) {
return statisticsAccuracy == STATISTICS_ACCURACY_NONE
|| statisticsAccuracy == STATISTICS_ACCURACY_BEST_EFFORT
|| statisticsAccuracy == STATISTICS_ACCURACY_GUARANTEED;
}
/**
* Gets the size of the write-behind queue, if any.
* The value is for all local buckets
* @return Elements waiting to be processed by the write behind writer. -1 if no write-behind
*/
public long getWriterQueueSize() {
return writerQueueLength;
}
}