org.apache.synapse.transport.passthru.jmx

Class LatencyView

java.lang.Object

org.apache.synapse.transport.passthru.jmx.LatencyView

All Implemented Interfaces:

LatencyViewMBean

public class LatencyView
extends Object
implements LatencyViewMBean

LatencyView provides statistical information related to the latency (overhead) incurred by the Synapse NHTTP transport, when mediating messages back and forth. Statistics are available under two main categories, namely short term data and long term data. Short term data is statistical information related to the last 15 minutes of execution and these metrics are updated every 5 seconds. Long term data is related to the last 24 hours of execution and they are updated every 5 minutes. Two timer tasks and a single threaded scheduled executor is used to perform these periodic calculations.

Latency calculation for a single invocation is carried out by taking timestamps on following events:

• t1 - Receiving a new request (ServerHandler#requestReceived)
• t2 - Obtaining a connection to forward the request (ClientHandler#processConnection)
• t3 - Reading the complete response from the backend server (ClientHandler#inputReady)
• t4 - Writing the complete response to the client (ServerHandler#outputReady)

Having taken these timestamps, the latency for the invocation is calculated as follows:
Latency = (t4 - t1) - (t3 - t2)

Constructor Summary

Constructors

Constructor and Description
LatencyView(boolean isHttps)

Method Summary

Modifier and Type	Method and Description
void	destroy()
double	getAllTimeAvgLatency()
double	getLast15MinuteAvgLatency()
double	getLast24HourAvgLatency()
double	getLast5MinuteAvgLatency()
double	getLast8HourAvgLatency()
double	getLastHourAvgLatency()
double	getLastMinuteAvgLatency()
Date	getLastResetTime()
void	notifyTimes(long reqArrival, long reqDeparture, long resArrival, long resDeparture) Report the timestamp values captured during mediating messages back and forth
void	reset()

Methods inherited from class java.lang.Object

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

Constructor Detail

LatencyView

public LatencyView(boolean isHttps)
            throws org.apache.axis2.AxisFault

Throws:

org.apache.axis2.AxisFault

Method Detail

destroy

public void destroy()

notifyTimes

public void notifyTimes(long reqArrival,
                        long reqDeparture,
                        long resArrival,
                        long resDeparture)

Report the timestamp values captured during mediating messages back and forth

Parameters:

reqArrival - The request arrival time

reqDeparture - The request departure time (backend connection establishment)

resArrival - The response arrival time

resDeparture - The response departure time

getAllTimeAvgLatency

public double getAllTimeAvgLatency()

Specified by:

getAllTimeAvgLatency in interface LatencyViewMBean

getLastMinuteAvgLatency

public double getLastMinuteAvgLatency()

Specified by:

getLastMinuteAvgLatency in interface LatencyViewMBean

getLast5MinuteAvgLatency

public double getLast5MinuteAvgLatency()

Specified by:

getLast5MinuteAvgLatency in interface LatencyViewMBean

getLast15MinuteAvgLatency

public double getLast15MinuteAvgLatency()

Specified by:

getLast15MinuteAvgLatency in interface LatencyViewMBean

getLastHourAvgLatency

public double getLastHourAvgLatency()

Specified by:

getLastHourAvgLatency in interface LatencyViewMBean

getLast8HourAvgLatency

public double getLast8HourAvgLatency()

Specified by:

getLast8HourAvgLatency in interface LatencyViewMBean

getLast24HourAvgLatency

public double getLast24HourAvgLatency()

Specified by:

getLast24HourAvgLatency in interface LatencyViewMBean

reset

public void reset()

Specified by:

reset in interface LatencyViewMBean

getLastResetTime

public Date getLastResetTime()

Specified by:

getLastResetTime in interface LatencyViewMBean