com.arjuna.ats.arjuna.coordinator

Interface TxStatsMBean

All Known Implementing Classes:

TxStats

public interface TxStatsMBean

MBean interface for monitoring transaction statistics.

Author:

Jonathan Halliday (jonathan.halliday@redhat.com)

Method Summary

Modifier and Type	Method and Description
long	getAverageCommitTime() Returns the average time, in nanoseconds, it is taking to commit a transaction.
long	getNumberOfAbortedTransactions() Returns the number of aborted (i.e.
long	getNumberOfApplicationRollbacks() Returns the number of transactions that have been rolled back by application request.
long	getNumberOfCommittedTransactions() Returns the number of committed transactions
long	getNumberOfHeuristics() Returns the number of transactions which have terminated with heuristic outcomes.
long	getNumberOfInflightTransactions() Get the number of transactions that have begun but not yet terminated.
long	getNumberOfNestedTransactions() Returns the total number of nested (sub) transactions created.
long	getNumberOfResourceRollbacks() Returns the number of transactions that rolled back due to resource (participant) failure.
long	getNumberOfSystemRollbacks() Returns the number of transactions that have been rolled back due to internal system errors including failure to create log storage and failure to write a transaction log.
long	getNumberOfTimedOutTransactions() Returns the number of transactions that have rolled back due to timeout.
long	getNumberOfTransactions() Returns the total number of transactions (top-level and nested) created

Method Detail

getNumberOfTransactions

long getNumberOfTransactions()

Returns the total number of transactions (top-level and nested) created

Returns:

the total number of transactions created

getNumberOfNestedTransactions

long getNumberOfNestedTransactions()

Returns the total number of nested (sub) transactions created. Note: in JTA environments will normally be 0, since JTA disallows nested tx by default.

Returns:

the total number of nested (sub) transactions created

getNumberOfHeuristics

long getNumberOfHeuristics()

Returns the number of transactions which have terminated with heuristic outcomes.

Returns:

the transactions which have terminated with heuristic outcomes

getNumberOfCommittedTransactions

long getNumberOfCommittedTransactions()

Returns the number of committed transactions

Returns:

rhe number of committed transactions

getAverageCommitTime

long getAverageCommitTime()

Returns the average time, in nanoseconds, it is taking to commit a transaction. This time is measured from the moment the client calls commit until the transaction manager determines that the commit attempt was successful (ie that all participants successfully committed). This includes cases where:

• there are no transaction participants;
• the transaction only contains readonly participants;

The average will not be updated if any participants failed to commit. Note that a small number of stuck transactions can skew the overall average. Similarly the average time will be reduced if there are many transactions without participants or with only readonly participants.

Returns:

the average time, in nanoseconds, it has taken to commit a transaction.

getNumberOfAbortedTransactions

long getNumberOfAbortedTransactions()

Returns the number of aborted (i.e. rolledback) transactions

Returns:

The number of rolledback transactions.

getNumberOfInflightTransactions

long getNumberOfInflightTransactions()

Get the number of transactions that have begun but not yet terminated. Note: This count is approximate, particularly in recovery situations.

Returns:

the number of transactions that have begun but not yet terminated

getNumberOfTimedOutTransactions

long getNumberOfTimedOutTransactions()

Returns the number of transactions that have rolled back due to timeout.

Returns:

the number of transactions that have rolled back due to timeout.

getNumberOfApplicationRollbacks

long getNumberOfApplicationRollbacks()

Returns the number of transactions that have been rolled back by application request. This includes those that timeout, since the timeout behaviour is considered an attribute of the application configuration.

Returns:

the number of transactions that have been rolled back by application request.

getNumberOfSystemRollbacks

long getNumberOfSystemRollbacks()

Returns the number of transactions that have been rolled back due to internal system errors including failure to create log storage and failure to write a transaction log. It does not include rollbacks caused by resource failures.

Returns:

the number of transactions that been rolled back due to internal system errors

getNumberOfResourceRollbacks

long getNumberOfResourceRollbacks()

Returns the number of transactions that rolled back due to resource (participant) failure.

Returns:

the number of transactions that rolled back due to resource (participant) failure.