net.anotheria.moskito.core.predefined

Class RequestOrientedStats

java.lang.Object

net.anotheria.moskito.core.producers.AbstractStats

net.anotheria.moskito.core.predefined.RequestOrientedStats

All Implemented Interfaces:

IStats, StatsMXBean

Direct Known Subclasses:

ActionStats, ServiceStats, ServletStats

public abstract class RequestOrientedStats
extends AbstractStats

This is an abstract class for all request oriented stats.

Author:

lrosenberg

Field Summary

Fields inherited from class net.anotheria.moskito.core.producers.AbstractStats

MB

Constructor Summary

Constructors

Constructor and Description
RequestOrientedStats() Creates a new anonymous stats.
RequestOrientedStats(java.lang.String aMethodName) Creates a new object with the given method name.
RequestOrientedStats(java.lang.String aMethodName, Interval[] aSelectedIntervals) Creates a new request oriented stats object with given method name and intervals.

Method Summary

Modifier and Type	Method and Description
void	addExecutionTime(long time) Adds messed execution time to the total execution time.
void	addRequest() Notifies about start of a new request.
CallExecution	createCallExecution() Creates a new call execution object.
java.util.List<java.lang.String>	getAvailableValueNames() Returns the names of all contained stats.
double	getAverageRequestDuration() Returns the average time of the request execution duration.
double	getAverageRequestDuration(java.lang.String intervalName) Returns the average request duration for the given interval in nanoseconds.
double	getAverageRequestDuration(java.lang.String intervalName, TimeUnit unit) Returns the average request duration for the given interval and converted to the given timeunit.
long	getCurrentRequests()
long	getCurrentRequests(java.lang.String intervalName)
double	getErrorRate(java.lang.String intervalName) Returns the error rate.
long	getErrors()
long	getErrors(java.lang.String intervalName) Returns the amount of errors for the given interval.
long	getLastRequest() Returns the duration of the last request in default interval in nanoseconds.
long	getLastRequest(java.lang.String intervalName) Returns the duration of the last request in an interval in nanoseconds.
long	getMaxCurrentRequests()
long	getMaxCurrentRequests(java.lang.String intervalName)
long	getMaxTime()
long	getMaxTime(java.lang.String intervalName)
java.lang.String	getMethodName() Returns the method name, which is the unique identifier of this stats object within its producer context.
long	getMinTime()
long	getMinTime(java.lang.String intervalName)
java.lang.String	getName() Returns the name of this request (effectively method name).
Interval[]	getSelectedIntervals()
long	getTotalRequests() Returns the total number of requests for the default interval.
long	getTotalRequests(java.lang.String intervalName)
long	getTotalTime() Returns the total spent time for the default interval.
long	getTotalTime(java.lang.String intervalName) Returns total spent time for the given interal.
java.lang.String	getValueByNameAsString(java.lang.String valueName, java.lang.String intervalName, TimeUnit timeUnit)
boolean	isEmpty(java.lang.String intervalName) Returns true if this stat object didn't record anything of interest in a given interval.
void	notifyError() Notifies about an uncaught error.
void	notifyError(java.lang.Throwable throwable) Notifies about an uncaught error.
void	notifyRequestFinished() Notifies that current request leaves the method body.
void	setMethodName(java.lang.String string) Sets the method name.
void	setSelectedIntervals(Interval[] selectedIntervals)
java.lang.String	toStatsString(java.lang.String intervalName, TimeUnit timeUnit) This method creates a human-readable textual representation of all statistical values in the given interval.
java.lang.String	toString() A string representation of this object.
java.lang.String	toString(java.lang.String intervalName) Returns a toString representation with values fo the given interval.

Methods inherited from class net.anotheria.moskito.core.producers.AbstractStats

addStatValues, destroy, toStatsString, toStatsString, toStatsString

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestOrientedStats

public RequestOrientedStats(java.lang.String aMethodName)

Creates a new object with the given method name.

Parameters:

aMethodName -

RequestOrientedStats

public RequestOrientedStats()

Creates a new anonymous stats.

RequestOrientedStats

public RequestOrientedStats(java.lang.String aMethodName,
                            Interval[] aSelectedIntervals)

Creates a new request oriented stats object with given method name and intervals.

Parameters:

aMethodName - the method name.

aSelectedIntervals - supported intervals.

Method Detail

addRequest

public void addRequest()

Notifies about start of a new request.

notifyRequestFinished

public void notifyRequestFinished()

Notifies that current request leaves the method body.

notifyError

public void notifyError()

Notifies about an uncaught error.

notifyError

public void notifyError(java.lang.Throwable throwable)

Notifies about an uncaught error.

addExecutionTime

public void addExecutionTime(long time)

Adds messed execution time to the total execution time.

Parameters:

time -

getAverageRequestDuration

public double getAverageRequestDuration()

Returns the average time of the request execution duration.

Returns:

average request duration for default internal.

getAverageRequestDuration

public double getAverageRequestDuration(java.lang.String intervalName)

Returns the average request duration for the given interval in nanoseconds.

Parameters:

intervalName - name of the interval.

Returns:

average request duration.

getAverageRequestDuration

public double getAverageRequestDuration(java.lang.String intervalName,
                                        TimeUnit unit)

Returns the average request duration for the given interval and converted to the given timeunit.

Parameters:

intervalName - name of the interval.

unit - timeunit.

Returns:

getErrorRate

public double getErrorRate(java.lang.String intervalName)

Returns the error rate. This value was previously calculated in decorator, but we moved it into the stats object to be able to define threshold on top of it.

Parameters:

intervalName - name of the interval.

Returns:

the error rate in percent.

toString

public java.lang.String toString()

A string representation of this object. It contains of a set of labels with according values. The labels are: TR, TT, CR, MCR, ERR and Avg Request Time.
TR - number of total requests.
TT - total execution time.
CR - current requests.
MCR - max concurrent requests.
ERR - number errors.
SL - number of sleeping requests.
MSL - max number of sleeping requests.
Avg Request Time - average request duration for this method.

Overrides:

toString in class AbstractStats

toStatsString

public java.lang.String toStatsString(java.lang.String intervalName,
                                      TimeUnit timeUnit)

Description copied from interface: IStats

This method creates a human-readable textual representation of all statistical values in the given interval.

Parameters:

intervalName - the name of the interval or null for all intervals

Returns:

the formatted text output

getValueByNameAsString

public java.lang.String getValueByNameAsString(java.lang.String valueName,
                                               java.lang.String intervalName,
                                               TimeUnit timeUnit)

Specified by:

getValueByNameAsString in interface IStats

Overrides:

getValueByNameAsString in class AbstractStats

toString

public java.lang.String toString(java.lang.String intervalName)

Returns a toString representation with values fo the given interval.

Parameters:

intervalName - the target interval.

Returns:

getMethodName

public java.lang.String getMethodName()

Returns the method name, which is the unique identifier of this stats object within its producer context.

Returns:

setMethodName

public void setMethodName(java.lang.String string)

Sets the method name.

Parameters:

string - method name parameter.

getTotalRequests

public long getTotalRequests(java.lang.String intervalName)

Returns:

getTotalRequests

public long getTotalRequests()

Returns the total number of requests for the default interval.

Returns:

number of requests.

getTotalTime

public long getTotalTime()

Returns the total spent time for the default interval.

Returns:

time spent in this stats in nanoseconds.

getTotalTime

public long getTotalTime(java.lang.String intervalName)

Returns total spent time for the given interal.

Parameters:

intervalName - the target interval.

Returns:

getCurrentRequests

public long getCurrentRequests(java.lang.String intervalName)

Returns:

getCurrentRequests

public long getCurrentRequests()

getMaxCurrentRequests

public long getMaxCurrentRequests(java.lang.String intervalName)

Returns:

getMaxCurrentRequests

public long getMaxCurrentRequests()

getErrors

public long getErrors()

Returns:

getErrors

public long getErrors(java.lang.String intervalName)

Returns the amount of errors for the given interval.

Parameters:

intervalName -

Returns:

getLastRequest

public long getLastRequest()

Returns the duration of the last request in default interval in nanoseconds.

Returns:

duration of last request in nanoseconds.

getLastRequest

public long getLastRequest(java.lang.String intervalName)

Returns the duration of the last request in an interval in nanoseconds.

Parameters:

intervalName -

Returns:

duration of last request in nanoseconds.

getSelectedIntervals

public Interval[] getSelectedIntervals()

setSelectedIntervals

public void setSelectedIntervals(Interval[] selectedIntervals)

getMinTime

public long getMinTime(java.lang.String intervalName)

getMinTime

public long getMinTime()

getMaxTime

public long getMaxTime(java.lang.String intervalName)

getMaxTime

public long getMaxTime()

getName

public java.lang.String getName()

Returns the name of this request (effectively method name).

Specified by:

getName in interface IStats

Overrides:

getName in class AbstractStats

Returns:

createCallExecution

public CallExecution createCallExecution()

Creates a new call execution object.

Specified by:

createCallExecution in interface IStats

Overrides:

createCallExecution in class AbstractStats

Returns:

getAvailableValueNames

public java.util.List<java.lang.String> getAvailableValueNames()

Description copied from interface: IStats

Returns the names of all contained stats.

Specified by:

getAvailableValueNames in interface IStats

Specified by:

getAvailableValueNames in interface StatsMXBean

Overrides:

getAvailableValueNames in class AbstractStats

Returns:

isEmpty

public boolean isEmpty(java.lang.String intervalName)

Description copied from interface: IStats

Returns true if this stat object didn't record anything of interest in a given interval. This is useful to reduce garbage.

Specified by:

isEmpty in interface IStats

Overrides:

isEmpty in class AbstractStats

Returns: