Interface TransactionManagerMBean

All Superinterfaces:

QBean, QBeanSupportMBean, QPersist

All Known Implementing Classes:

TransactionManager

public interface TransactionManagerMBean
extends QBeanSupportMBean

JMX management interface exposing the TransactionManager's queue counters and TPS (transactions-per-second) metrics.

Field Summary

Fields inherited from interface QBean

DESTROYED, FAILED, STARTED, STARTING, stateString, STOPPED, STOPPING

Modifier and Type	Field	Description
static final int	DESTROYED	QBean has been destroyed.
static final int	FAILED	QBean has failed.
static final int	STARTED	QBean is running.
static final int	STARTING	QBean is in the process of starting.
static final String[]	stateString	Human-readable names for each QBean state, indexed by state constant.
static final int	STOPPED	QBean is stopped.
static final int	STOPPING	QBean is in the process of stopping.

Method Summary

Modifier and Type	Method	Description
int	getActiveSessions()	Returns the number of session threads currently processing transactions.
long	getHead()	Returns the current head index of the transaction queue.
int	getMaxSessions()	Returns the configured maximum number of concurrent session threads.
int	getOutstandingTransactions()	Returns the number of in-flight transactions (tail - head).
long	getTail()	Returns the current tail index of the transaction queue.
String	getTPSAsString()	Returns a human-readable summary of TPS statistics.
float	getTPSAvg()	Returns the average transactions-per-second since the last reset.
long	getTPSElapsed()	Returns the elapsed time in milliseconds covered by the current TPS window.
int	getTPSPeak()	Returns the peak transactions-per-second observed since the last reset.
Date	getTPSPeakWhen()	Returns the wall-clock instant at which getTPSPeak() was reached.
void	resetTPS()	Resets the TPS counters and start time.

Methods inherited from interface QBean

destroy, getState, getStateAsString, init, start, stop

Modifier and Type	Method	Description
void	destroy()	destroy the service
int	getState()	Returns the current state of this QBean.
default String	getStateAsString()	Returns the current state as a human-readable string.
void	init()	init the service
void	start()	start the service
void	stop()	stop the service

Methods inherited from interface QBeanSupportMBean

getDump, getLoader, getLoaderURLS, getLogger, getName, getRealm, getServer, setLogger, setName, setPersist, setRealm, setServer

Modifier and Type	Method	Description
String	getDump()	Returns a human-readable dump of this bean's state.
QClassLoader	getLoader()	Returns the QClassLoader for this bean.
URL[]	getLoaderURLS()	Returns the URLs registered with the class loader.
String	getLogger()	Returns the logger name.
String	getName()	Returns the bean name.
String	getRealm()	Returns the logging realm.
Q2	getServer()	Returns the Q2 server instance.
void	setLogger(String name)	Sets the logger by name.
void	setName(String name)	Sets the bean name.
void	setPersist(org.jdom2.Element e)	Sets the persistent configuration element.
void	setRealm(String realm)	Sets the logging realm.
void	setServer(Q2 server)	Sets the Q2 server instance for this QBean.

Methods inherited from interface QPersist

getPersist, isModified

Modifier and Type	Method	Description
org.jdom2.Element	getPersist()	Returns the persistent configuration element for this QBean.
boolean	isModified()	Returns true if this QBean's configuration has been modified since last save.

Method Details

getHead

long getHead()

Returns the current head index of the transaction queue.

Returns:

queue head index

getTail

long getTail()

Returns the current tail index of the transaction queue.

Returns:

queue tail index

getOutstandingTransactions

int getOutstandingTransactions()

Returns the number of in-flight transactions (tail - head).

Returns:

outstanding transaction count

getActiveSessions

int getActiveSessions()

Returns the number of session threads currently processing transactions.

Returns:

live session count

getMaxSessions

int getMaxSessions()

Returns the configured maximum number of concurrent session threads.

Returns:

maximum session count

getTPSAsString

String getTPSAsString()

Returns a human-readable summary of TPS statistics.

Returns:

TPS snapshot suitable for diagnostics

getTPSAvg

float getTPSAvg()

Returns the average transactions-per-second since the last reset.

Returns:

mean TPS

getTPSPeak

int getTPSPeak()

Returns the peak transactions-per-second observed since the last reset.

Returns:

peak TPS

getTPSPeakWhen

Date getTPSPeakWhen()

Returns the wall-clock instant at which getTPSPeak() was reached.

Returns:

timestamp of the TPS peak, or null if not yet observed

getTPSElapsed

long getTPSElapsed()

Returns the elapsed time in milliseconds covered by the current TPS window.

Returns:

elapsed window in milliseconds

resetTPS

void resetTPS()

Resets the TPS counters and start time.