net.sf.sparql.benchmarking.stats

Interface OperationStats

All Known Implementing Classes:

OperationStatsImpl

public interface OperationStats

Interface for classes that store and represent statistics about an operation

Author:

rvesse

Method Summary

Methods

Modifier and Type	Method and Description
void	add(OperationRun run) Adds information for the given run to the statistics
void	clear() Clears all run statistics
long	getActualAverageRuntime() Gets average runtime for the operation over all runs (arithmetic mean) based on the actual runtime
double	getActualOperationsPerHour() Calculates how many times this operation could be executed multi-threaded per hour based upon the getActualAverageRuntime()
double	getActualOperationsPerSecond() Calculates how many times this operation could be executed multi-threaded per second based upon the getActualAverageRuntime()
long	getActualRuntime() Gets the actual runtime for the operation over all runs (takes into account operations that run in parallel)
long	getAverageResponseTime() Gets the average response time over all runs (arithmetic mean) based on the total response time
long	getAverageResults() Gets the average number of results
long	getAverageRuntime() Gets the average runtime for the operation over all runs (arithmetic mean) based on the total runtime
Map<Integer,List<OperationRun>>	getCategorizedErrors() Gets the information for all errors grouped by category
double	getGeometricAverageRuntime() Gets the average runtime for the operation over all runs (geometric mean) based on the total runtime
long	getMaximumRuntime() Gets the maximum runtime for this operation over all runs
long	getMinimumRuntime() Gets the minimum runtime for this operation over all runs
double	getOperationsPerHour() Calculates how many times this operation could be executed single-threaded per hour based upon the average runtime of the operation
double	getOperationsPerSecond() Calculates how many times this operation could be executed single-threaded per second based upon the average runtime of the operation
long	getRunCount() Gets the number of runs for the operation
Iterator<OperationRun>	getRuns() Gets an iterator over the operation runs
double	getStandardDeviation() Gets the standard deviation for operation runtime
ParallelTimer	getTimer() Gets the parallel timer used to track actual runtime
long	getTotalErrors() Gets the total number of times this operation resulted in an error
long	getTotalResponseTime() Gets the total response time for the operations over all runs
long	getTotalResults() Gets the total number of results for this operation
long	getTotalRuntime() Gets the total runtime for the query over all runs
double	getVariance() Gets the variance for the operation runtimes
void	trim(int outliers) Trims the best and worst N runs

Method Detail

getRuns

Iterator<OperationRun> getRuns()

Gets an iterator over the operation runs

Returns:

Runs of the operation

getRunCount

long getRunCount()

Gets the number of runs for the operation

Returns:

Number of runs

getTotalRuntime

long getTotalRuntime()

Gets the total runtime for the query over all runs

Returns:

Total Runtime in nanoseconds

getActualRuntime

long getActualRuntime()

Gets the actual runtime for the operation over all runs (takes into account operations that run in parallel)

Returns:

Actual Runtime in nanoseconds

getTotalResponseTime

long getTotalResponseTime()

Gets the total response time for the operations over all runs

For non-streaming operations this will likely be equal to getTotalRuntime()

Returns:

Total response time

getAverageRuntime

long getAverageRuntime()

Gets the average runtime for the operation over all runs (arithmetic mean) based on the total runtime

Returns:

Arithmetic Average Runtime in nanoseconds

getAverageResponseTime

long getAverageResponseTime()

Gets the average response time over all runs (arithmetic mean) based on the total response time

For non-streaming operations this will likely be equal to getAverageRuntime()

Returns:

Average Response Time in nanoseconds

getGeometricAverageRuntime

double getGeometricAverageRuntime()

Gets the average runtime for the operation over all runs (geometric mean) based on the total runtime

Returns:

Geometric Average Runtime in nanoseconds

getActualAverageRuntime

long getActualAverageRuntime()

Gets average runtime for the operation over all runs (arithmetic mean) based on the actual runtime

Returns:

Arithmetic Average runtime in nanoseconds

getMinimumRuntime

long getMinimumRuntime()

Gets the minimum runtime for this operation over all runs

Returns:

Minimum Runtime in nanoseconds

getMaximumRuntime

long getMaximumRuntime()

Gets the maximum runtime for this operation over all runs

Returns:

Maximum Runtime in nanoseconds

getVariance

double getVariance()

Gets the variance for the operation runtimes

Returns:

Runtime Variance in nanoseconds squared

getStandardDeviation

double getStandardDeviation()

Gets the standard deviation for operation runtime

Returns:

Runtime Standard Deviation in nanoseconds

getTotalErrors

long getTotalErrors()

Gets the total number of times this operation resulted in an error

Returns:

Total number of errors

getCategorizedErrors

Map<Integer,List<OperationRun>> getCategorizedErrors()

Gets the information for all errors grouped by category

Returns:

Errors grouped by category

getTotalResults

long getTotalResults()

Gets the total number of results for this operation

Returns:

Total number of results

getAverageResults

long getAverageResults()

Gets the average number of results

Returns:

Average number of results

getOperationsPerSecond

double getOperationsPerSecond()

Calculates how many times this operation could be executed single-threaded per second based upon the average runtime of the operation

Returns:

Operations per Second

getActualOperationsPerSecond

double getActualOperationsPerSecond()

Calculates how many times this operation could be executed multi-threaded per second based upon the getActualAverageRuntime()

Returns:

Actual Operations per Second

getOperationsPerHour

double getOperationsPerHour()

Calculates how many times this operation could be executed single-threaded per hour based upon the average runtime of the operation

Returns:

Operations per Hour

getActualOperationsPerHour

double getActualOperationsPerHour()

Calculates how many times this operation could be executed multi-threaded per hour based upon the getActualAverageRuntime()

Returns:

Actual Operations per Hour

add

void add(OperationRun run)

Adds information for the given run to the statistics

Parameters:

run - Run information

clear

void clear()

Clears all run statistics

trim

void trim(int outliers)

Trims the best and worst N runs

Parameters:

outliers - Number of outliers to trim

getTimer

ParallelTimer getTimer()

Gets the parallel timer used to track actual runtime

Returns:

Parallel timer