org.eclipse.jetty.server.handler

Class StatisticsHandler

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.handler.AbstractHandler

org.eclipse.jetty.server.handler.AbstractHandlerContainer

org.eclipse.jetty.server.handler.HandlerWrapper

org.eclipse.jetty.server.handler.StatisticsHandler

All Implemented Interfaces:

Handler, HandlerContainer, Container, Destroyable, Dumpable, Graceful, LifeCycle

@ManagedObject(value="Request Statistics Gathering")
public class StatisticsHandler
extends HandlerWrapper
implements Graceful

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

_handler

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
StatisticsHandler()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doStart() Starts the managed lifecycle beans in the order they were added.
protected void	doStop() Stops the managed lifecycle beans in the reverse order they were added.
int	getAsyncDispatches()
int	getAsyncRequests()
int	getAsyncRequestsWaiting()
int	getAsyncRequestsWaitingMax()
int	getDispatched()
int	getDispatchedActive()
int	getDispatchedActiveMax()
long	getDispatchedTimeMax()
double	getDispatchedTimeMean()
double	getDispatchedTimeStdDev()
long	getDispatchedTimeTotal()
int	getExpires()
int	getRequests()
int	getRequestsActive()
int	getRequestsActiveMax()
long	getRequestTimeMax()
double	getRequestTimeMean()
double	getRequestTimeStdDev()
long	getRequestTimeTotal()
int	getResponses1xx()
int	getResponses2xx()
int	getResponses3xx()
int	getResponses4xx()
int	getResponses5xx()
long	getResponsesBytesTotal()
long	getStatsOnMs()
void	handle(String path, Request request, HttpServletRequest httpRequest, HttpServletResponse httpResponse) Handle a request.
Future<Void>	shutdown()
void	statsReset() Resets the current request statistics.
String	toStatsHTML()
protected void	updateResponse(Request request)

Methods inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

destroy, expandChildren, getHandler, getHandlers, setHandler, setServer

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandlerContainer

expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler

dumpThis, getServer

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Constructor Detail

StatisticsHandler

public StatisticsHandler()

Method Detail

statsReset

@ManagedOperation(value="resets statistics",
                  impact="ACTION")
public void statsReset()

Resets the current request statistics.

handle

public void handle(String path,
          Request request,
          HttpServletRequest httpRequest,
          HttpServletResponse httpResponse)
            throws IOException,
                   ServletException

Description copied from interface: Handler

Handle a request.

Specified by:

handle in interface Handler

Overrides:

handle in class HandlerWrapper

Parameters:

path - The target of the request - either a URI or a name.

request - The original unwrapped request object.

httpRequest - The request either as the Request object or a wrapper of that request. The HttpChannel.getCurrentHttpChannel() method can be used access the Request object if required.

httpResponse - The response as the Response object or a wrapper of that request. The HttpChannel.getCurrentHttpChannel() method can be used access the Response object if required.

Throws:

IOException

ServletException

updateResponse

protected void updateResponse(Request request)

doStart

protected void doStart()
                throws Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class AbstractHandler

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Description copied from class: ContainerLifeCycle

Stops the managed lifecycle beans in the reverse order they were added.

Overrides:

doStop in class AbstractHandler

Throws:

Exception

getRequests

@ManagedAttribute(value="number of requests")
public int getRequests()

Returns:

the number of requests handled by this handler since statsReset() was last called, excluding active requests

See Also:

getAsyncDispatches()

getRequestsActive

@ManagedAttribute(value="number of requests currently active")
public int getRequestsActive()

Returns:

the number of requests currently active. since statsReset() was last called.

getRequestsActiveMax

@ManagedAttribute(value="maximum number of active requests")
public int getRequestsActiveMax()

Returns:

the maximum number of active requests since statsReset() was last called.

getRequestTimeMax

@ManagedAttribute(value="maximum time spend handling requests (in ms)")
public long getRequestTimeMax()

Returns:

the maximum time (in milliseconds) of request handling since statsReset() was last called.

getRequestTimeTotal

@ManagedAttribute(value="total time spend in all request handling (in ms)")
public long getRequestTimeTotal()

Returns:

the total time (in milliseconds) of requests handling since statsReset() was last called.

getRequestTimeMean

@ManagedAttribute(value="mean time spent handling requests (in ms)")
public double getRequestTimeMean()

Returns:

the mean time (in milliseconds) of request handling since statsReset() was last called.

See Also:

getRequestTimeTotal(), getRequests()

getRequestTimeStdDev

@ManagedAttribute(value="standard deviation for request handling (in ms)")
public double getRequestTimeStdDev()

Returns:

the standard deviation of time (in milliseconds) of request handling since statsReset() was last called.

See Also:

getRequestTimeTotal(), getRequests()

getDispatched

@ManagedAttribute(value="number of dispatches")
public int getDispatched()

Returns:

the number of dispatches seen by this handler since statsReset() was last called, excluding active dispatches

getDispatchedActive

@ManagedAttribute(value="number of dispatches currently active")
public int getDispatchedActive()

Returns:

the number of dispatches currently in this handler since statsReset() was last called, including resumed requests

getDispatchedActiveMax

@ManagedAttribute(value="maximum number of active dispatches being handled")
public int getDispatchedActiveMax()

Returns:

the max number of dispatches currently in this handler since statsReset() was last called, including resumed requests

getDispatchedTimeMax

@ManagedAttribute(value="maximum time spend in dispatch handling")
public long getDispatchedTimeMax()

Returns:

the maximum time (in milliseconds) of request dispatch since statsReset() was last called.

getDispatchedTimeTotal

@ManagedAttribute(value="total time spent in dispatch handling (in ms)")
public long getDispatchedTimeTotal()

Returns:

the total time (in milliseconds) of requests handling since statsReset() was last called.

getDispatchedTimeMean

@ManagedAttribute(value="mean time spent in dispatch handling (in ms)")
public double getDispatchedTimeMean()

Returns:

the mean time (in milliseconds) of request handling since statsReset() was last called.

See Also:

getRequestTimeTotal(), getRequests()

getDispatchedTimeStdDev

@ManagedAttribute(value="standard deviation for dispatch handling (in ms)")
public double getDispatchedTimeStdDev()

Returns:

the standard deviation of time (in milliseconds) of request handling since statsReset() was last called.

See Also:

getRequestTimeTotal(), getRequests()

getAsyncRequests

@ManagedAttribute(value="total number of async requests")
public int getAsyncRequests()

Returns:

the number of requests handled by this handler since statsReset() was last called, including resumed requests

See Also:

getAsyncDispatches()

getAsyncRequestsWaiting

@ManagedAttribute(value="currently waiting async requests")
public int getAsyncRequestsWaiting()

Returns:

the number of requests currently suspended. since statsReset() was last called.

getAsyncRequestsWaitingMax

@ManagedAttribute(value="maximum number of waiting async requests")
public int getAsyncRequestsWaitingMax()

Returns:

the maximum number of current suspended requests since statsReset() was last called.

getAsyncDispatches

@ManagedAttribute(value="number of requested that have been asynchronously dispatched")
public int getAsyncDispatches()

Returns:

the number of requests that have been asynchronously dispatched

getExpires

@ManagedAttribute(value="number of async requests requests that have expired")
public int getExpires()

Returns:

the number of requests that expired while suspended.

See Also:

getAsyncDispatches()

getResponses1xx

@ManagedAttribute(value="number of requests with 1xx response status")
public int getResponses1xx()

Returns:

the number of responses with a 1xx status returned by this context since statsReset() was last called.

getResponses2xx

@ManagedAttribute(value="number of requests with 2xx response status")
public int getResponses2xx()

Returns:

the number of responses with a 2xx status returned by this context since statsReset() was last called.

getResponses3xx

@ManagedAttribute(value="number of requests with 3xx response status")
public int getResponses3xx()

Returns:

the number of responses with a 3xx status returned by this context since statsReset() was last called.

getResponses4xx

@ManagedAttribute(value="number of requests with 4xx response status")
public int getResponses4xx()

Returns:

the number of responses with a 4xx status returned by this context since statsReset() was last called.

getResponses5xx

@ManagedAttribute(value="number of requests with 5xx response status")
public int getResponses5xx()

Returns:

the number of responses with a 5xx status returned by this context since statsReset() was last called.

getStatsOnMs

@ManagedAttribute(value="time in milliseconds stats have been collected for")
public long getStatsOnMs()

Returns:

the milliseconds since the statistics were started with statsReset().

getResponsesBytesTotal

@ManagedAttribute(value="total number of bytes across all responses")
public long getResponsesBytesTotal()

Returns:

the total bytes of content sent in responses

toStatsHTML

public String toStatsHTML()

shutdown

public Future<Void> shutdown()

Specified by:

shutdown in interface Graceful