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 TypeMethodDescriptionlongReturns the average time, in nanoseconds, it is taking to commit a transaction.longReturns the number of aborted (i.e.longReturns the number of transactions that have been rolled back by application request.longReturns the number of committed transactionslongReturns the number of transactions which have terminated with heuristic outcomes.longGet the number of transactions that have begun but not yet terminated.longReturns the total number of nested (sub) transactions created.longReturns the number of transactions that rolled back due to resource (participant) failure.longReturns 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.longReturns the number of transactions that have rolled back due to timeout.longReturns the total number of transactions (top-level and nested) created
-
Method Details
-
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;
- 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.
-