com.lazerycode.jmeter.analyzer.statistics

Class Samples

java.lang.Object

com.lazerycode.jmeter.analyzer.statistics.Samples

public class Samples
extends Object

Collects samples (as a sequence of values of type "long") and provides the following values:

• min: Minimum value
• max: Maximum value
• average: Average value
• standard deviation
• samples per second
• quantiles

Author:

Dennis Homann, Arne Franken, Peter Kaul

Constructor Summary

Constructors

Constructor and Description
Samples(int maxSamples, boolean histogram) Creates a new instance where a limited number of samples is stored internally.

Method Summary

Methods

Modifier and Type	Method and Description
void	addError(long timestamp) Adds an "error" sample.
void	addSample(long timestamp, long value) Adds a "success" sample
void	finish() Marks collecting samples as "finished"
long	getAverage()
long	getDuration()
long	getErrorsCount()
long	getMax()
long	getMaxTimestamp()
long	getMin()
long	getMinTimestamp()
Quantile	getQuantiles(int q) Returns a Quantile with the grade/resolution q using counts as values
List<Long>	getSamples()
long	getStandardDeviation()
long	getStoredSamplesCount()
long	getSuccessCount()
long	getSuccessPerSecond()
List<Long>	getTimestamps()
long	getTotal()
boolean	hasSamples()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Samples

public Samples(int maxSamples,
       boolean histogram)

Creates a new instance where a limited number of samples is stored internally. If more samples are added, existing samples will be compressed internally.

Parameters:

maxSamples - The maximum number of samples. 0=store no samples

histogram - If set to true the a value histogram should be counted as well.

Method Detail

addError

public void addError(long timestamp)

Adds an "error" sample. An error sample isn't used for statistics values such as average, ...

Parameters:

timestamp - The timestamp of the sample. It's assumed that a timestamp is greater or equal than the previous one

addSample

public void addSample(long timestamp,
             long value)

Adds a "success" sample

Parameters:

timestamp - The timestamp of the sample. It's assumed that a timestamp is greater or equal than the previous one

value - The sample value, e.g. the response duration or response bytes

See Also:

addError(long)

finish

public void finish()

Marks collecting samples as "finished"

hasSamples

public boolean hasSamples()

Returns:

Determines whether a relevant number of samples have been provided so that statistics can be computed

getSamples

public List<Long> getSamples()

getTimestamps

public List<Long> getTimestamps()

Returns:

The sample's timestamp.

getStoredSamplesCount

public long getStoredSamplesCount()

Returns:

Total number of stored samples

See Also:

getSuccessCount()

getSuccessCount

public long getSuccessCount()

Returns:

Total number of successful samples

getErrorsCount

public long getErrorsCount()

Returns:

Total number of samples having an error

getMin

public long getMin()

getMax

public long getMax()

getAverage

public long getAverage()

Returns:

The average for all samples

getTotal

public long getTotal()

getStandardDeviation

public long getStandardDeviation()

getMaxTimestamp

public long getMaxTimestamp()

getMinTimestamp

public long getMinTimestamp()

getSuccessPerSecond

public long getSuccessPerSecond()

Returns:

Number of successful samples per second

getDuration

public long getDuration()

Returns:

The duration in s

getQuantiles

public Quantile getQuantiles(int q)

Returns a Quantile with the grade/resolution q using counts as values

Parameters:

q - the grade

Returns:

the q-quantile.