Record Class MetricsCollector.Snapshot

java.lang.Object

java.lang.Record

com.pyranid.MetricsCollector.Snapshot

Record Components:

connectionsAcquiredStatementScope - statement-scoped connection acquisitions that completed normally

connectionsAcquiredTransactionScope - transaction-scoped connection acquisitions that completed normally

connectionsFailedStatementScope - statement-scoped connection acquisitions that failed

connectionsFailedTransactionScope - transaction-scoped connection acquisitions that failed

connectionReleaseFailuresStatementScope - statement-scoped connection releases that failed

connectionReleaseFailuresTransactionScope - transaction-scoped connection releases that failed

transactionClosuresEntered - closure-based transactions entered

transactionClosuresExited - closure-based transactions exited

transactionClosuresCommitted - closure-based transactions that committed

transactionClosuresRolledBack - closure-based transactions that rolled back

transactionClosuresNoPhysical - closure-based transactions that exited without a physical JDBC transaction

transactionClosuresFailed - closure-based transactions that failed before a normal commit or rollback outcome

physicalTransactionsBegun - physical JDBC transactions begun

physicalTransactionsBeginFailed - physical JDBC transactions that failed while beginning

physicalTransactionsCommitted - physical JDBC transactions committed

physicalTransactionsCommitFailed - physical JDBC transactions whose commit failed

physicalTransactionsRolledBack - physical JDBC transactions rolled back

physicalTransactionsRollbackFailed - physical JDBC transactions whose rollback failed

savepointsCreated - transaction savepoints created

savepointsRolledBack - transaction savepoints rolled back to

savepointsReleased - transaction savepoints released

statementsExecuted - statements that executed successfully

statementsFailed - statements that failed during execution

streamsOpened - streams that opened successfully

streamsOpenFailures - streams that failed before opening

streamsClosedNormally - opened streams that reached the end of the result set

streamsEarlyClosed - opened streams that closed before all rows were consumed

streamsCallbackFailed - opened streams whose caller-provided callback failed

streamsIterationFailed - opened streams whose result-set iteration failed

postTransactionOperationsRun - post-transaction operations that ran

postTransactionOperationsFailed - post-transaction operations that failed

Enclosing interface:

MetricsCollector

@ThreadSafe
public static record MetricsCollector.Snapshot(@NonNull Long connectionsAcquiredStatementScope, @NonNull Long connectionsAcquiredTransactionScope, @NonNull Long connectionsFailedStatementScope, @NonNull Long connectionsFailedTransactionScope, @NonNull Long connectionReleaseFailuresStatementScope, @NonNull Long connectionReleaseFailuresTransactionScope, @NonNull Long transactionClosuresEntered, @NonNull Long transactionClosuresExited, @NonNull Long transactionClosuresCommitted, @NonNull Long transactionClosuresRolledBack, @NonNull Long transactionClosuresNoPhysical, @NonNull Long transactionClosuresFailed, @NonNull Long physicalTransactionsBegun, @NonNull Long physicalTransactionsBeginFailed, @NonNull Long physicalTransactionsCommitted, @NonNull Long physicalTransactionsCommitFailed, @NonNull Long physicalTransactionsRolledBack, @NonNull Long physicalTransactionsRollbackFailed, @NonNull Long savepointsCreated, @NonNull Long savepointsRolledBack, @NonNull Long savepointsReleased, @NonNull Long statementsExecuted, @NonNull Long statementsFailed, @NonNull Long streamsOpened, @NonNull Long streamsOpenFailures, @NonNull Long streamsClosedNormally, @NonNull Long streamsEarlyClosed, @NonNull Long streamsCallbackFailed, @NonNull Long streamsIterationFailed, @NonNull Long postTransactionOperationsRun, @NonNull Long postTransactionOperationsFailed)
extends Record

Counter snapshot for collectors that support in-process inspection.

Implementations may read counters independently without cross-counter atomicity. Callers that need invariant-consistent snapshots should drain in-flight work before reading.

Since:

4.2.0

Author:

Mark Allen

Constructor Summary

Constructors

Constructor

Description

Snapshot(@NonNull Long connectionsAcquiredStatementScope, @NonNull Long connectionsAcquiredTransactionScope, @NonNull Long connectionsFailedStatementScope, @NonNull Long connectionsFailedTransactionScope, @NonNull Long connectionReleaseFailuresStatementScope, @NonNull Long connectionReleaseFailuresTransactionScope, @NonNull Long transactionClosuresEntered, @NonNull Long transactionClosuresExited, @NonNull Long transactionClosuresCommitted, @NonNull Long transactionClosuresRolledBack, @NonNull Long transactionClosuresNoPhysical, @NonNull Long transactionClosuresFailed, @NonNull Long physicalTransactionsBegun, @NonNull Long physicalTransactionsBeginFailed, @NonNull Long physicalTransactionsCommitted, @NonNull Long physicalTransactionsCommitFailed, @NonNull Long physicalTransactionsRolledBack, @NonNull Long physicalTransactionsRollbackFailed, @NonNull Long savepointsCreated, @NonNull Long savepointsRolledBack, @NonNull Long savepointsReleased, @NonNull Long statementsExecuted, @NonNull Long statementsFailed, @NonNull Long streamsOpened, @NonNull Long streamsOpenFailures, @NonNull Long streamsClosedNormally, @NonNull Long streamsEarlyClosed, @NonNull Long streamsCallbackFailed, @NonNull Long streamsIterationFailed, @NonNull Long postTransactionOperationsRun, @NonNull Long postTransactionOperationsFailed)

Creates an instance of a Snapshot record class.

Method Summary

Modifier and Type	Method	Description
@NonNull Long	connectionReleaseFailuresStatementScope()	Returns the value of the connectionReleaseFailuresStatementScope record component.
@NonNull Long	connectionReleaseFailuresTransactionScope()	Returns the value of the connectionReleaseFailuresTransactionScope record component.
@NonNull Long	connectionsAcquiredStatementScope()	Returns the value of the connectionsAcquiredStatementScope record component.
@NonNull Long	connectionsAcquiredTransactionScope()	Returns the value of the connectionsAcquiredTransactionScope record component.
@NonNull Long	connectionsFailedStatementScope()	Returns the value of the connectionsFailedStatementScope record component.
@NonNull Long	connectionsFailedTransactionScope()	Returns the value of the connectionsFailedTransactionScope record component.
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
final int	hashCode()	Returns a hash code value for this object.
@NonNull Long	physicalTransactionsBeginFailed()	Returns the value of the physicalTransactionsBeginFailed record component.
@NonNull Long	physicalTransactionsBegun()	Returns the value of the physicalTransactionsBegun record component.
@NonNull Long	physicalTransactionsCommitFailed()	Returns the value of the physicalTransactionsCommitFailed record component.
@NonNull Long	physicalTransactionsCommitted()	Returns the value of the physicalTransactionsCommitted record component.
@NonNull Long	physicalTransactionsRollbackFailed()	Returns the value of the physicalTransactionsRollbackFailed record component.
@NonNull Long	physicalTransactionsRolledBack()	Returns the value of the physicalTransactionsRolledBack record component.
@NonNull Long	postTransactionOperationsFailed()	Returns the value of the postTransactionOperationsFailed record component.
@NonNull Long	postTransactionOperationsRun()	Returns the value of the postTransactionOperationsRun record component.
@NonNull Long	savepointsCreated()	Returns the value of the savepointsCreated record component.
@NonNull Long	savepointsReleased()	Returns the value of the savepointsReleased record component.
@NonNull Long	savepointsRolledBack()	Returns the value of the savepointsRolledBack record component.
@NonNull Long	statementsExecuted()	Returns the value of the statementsExecuted record component.
@NonNull Long	statementsFailed()	Returns the value of the statementsFailed record component.
@NonNull Long	streamsCallbackFailed()	Returns the value of the streamsCallbackFailed record component.
@NonNull Long	streamsClosedNormally()	Returns the value of the streamsClosedNormally record component.
@NonNull Long	streamsEarlyClosed()	Returns the value of the streamsEarlyClosed record component.
@NonNull Long	streamsIterationFailed()	Returns the value of the streamsIterationFailed record component.
@NonNull Long	streamsOpened()	Returns the value of the streamsOpened record component.
@NonNull Long	streamsOpenFailures()	Returns the value of the streamsOpenFailures record component.
final String	toString()	Returns a string representation of this record class.
@NonNull Long	transactionClosuresCommitted()	Returns the value of the transactionClosuresCommitted record component.
@NonNull Long	transactionClosuresEntered()	Returns the value of the transactionClosuresEntered record component.
@NonNull Long	transactionClosuresExited()	Returns the value of the transactionClosuresExited record component.
@NonNull Long	transactionClosuresFailed()	Returns the value of the transactionClosuresFailed record component.
@NonNull Long	transactionClosuresNoPhysical()	Returns the value of the transactionClosuresNoPhysical record component.
@NonNull Long	transactionClosuresRolledBack()	Returns the value of the transactionClosuresRolledBack record component.

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Details

Snapshot

public Snapshot(@NonNull Long connectionsAcquiredStatementScope,
 @NonNull Long connectionsAcquiredTransactionScope,
 @NonNull Long connectionsFailedStatementScope,
 @NonNull Long connectionsFailedTransactionScope,
 @NonNull Long connectionReleaseFailuresStatementScope,
 @NonNull Long connectionReleaseFailuresTransactionScope,
 @NonNull Long transactionClosuresEntered,
 @NonNull Long transactionClosuresExited,
 @NonNull Long transactionClosuresCommitted,
 @NonNull Long transactionClosuresRolledBack,
 @NonNull Long transactionClosuresNoPhysical,
 @NonNull Long transactionClosuresFailed,
 @NonNull Long physicalTransactionsBegun,
 @NonNull Long physicalTransactionsBeginFailed,
 @NonNull Long physicalTransactionsCommitted,
 @NonNull Long physicalTransactionsCommitFailed,
 @NonNull Long physicalTransactionsRolledBack,
 @NonNull Long physicalTransactionsRollbackFailed,
 @NonNull Long savepointsCreated,
 @NonNull Long savepointsRolledBack,
 @NonNull Long savepointsReleased,
 @NonNull Long statementsExecuted,
 @NonNull Long statementsFailed,
 @NonNull Long streamsOpened,
 @NonNull Long streamsOpenFailures,
 @NonNull Long streamsClosedNormally,
 @NonNull Long streamsEarlyClosed,
 @NonNull Long streamsCallbackFailed,
 @NonNull Long streamsIterationFailed,
 @NonNull Long postTransactionOperationsRun,
 @NonNull Long postTransactionOperationsFailed)

Creates an instance of a Snapshot record class.

Parameters:

connectionsAcquiredStatementScope - the value for the connectionsAcquiredStatementScope record component

connectionsAcquiredTransactionScope - the value for the connectionsAcquiredTransactionScope record component

connectionsFailedStatementScope - the value for the connectionsFailedStatementScope record component

connectionsFailedTransactionScope - the value for the connectionsFailedTransactionScope record component

connectionReleaseFailuresStatementScope - the value for the connectionReleaseFailuresStatementScope record component

connectionReleaseFailuresTransactionScope - the value for the connectionReleaseFailuresTransactionScope record component

transactionClosuresEntered - the value for the transactionClosuresEntered record component

transactionClosuresExited - the value for the transactionClosuresExited record component

transactionClosuresCommitted - the value for the transactionClosuresCommitted record component

transactionClosuresRolledBack - the value for the transactionClosuresRolledBack record component

transactionClosuresNoPhysical - the value for the transactionClosuresNoPhysical record component

transactionClosuresFailed - the value for the transactionClosuresFailed record component

physicalTransactionsBegun - the value for the physicalTransactionsBegun record component

physicalTransactionsBeginFailed - the value for the physicalTransactionsBeginFailed record component

physicalTransactionsCommitted - the value for the physicalTransactionsCommitted record component

physicalTransactionsCommitFailed - the value for the physicalTransactionsCommitFailed record component

physicalTransactionsRolledBack - the value for the physicalTransactionsRolledBack record component

physicalTransactionsRollbackFailed - the value for the physicalTransactionsRollbackFailed record component

savepointsCreated - the value for the savepointsCreated record component

savepointsRolledBack - the value for the savepointsRolledBack record component

savepointsReleased - the value for the savepointsReleased record component

statementsExecuted - the value for the statementsExecuted record component

statementsFailed - the value for the statementsFailed record component

streamsOpened - the value for the streamsOpened record component

streamsOpenFailures - the value for the streamsOpenFailures record component

streamsClosedNormally - the value for the streamsClosedNormally record component

streamsEarlyClosed - the value for the streamsEarlyClosed record component

streamsCallbackFailed - the value for the streamsCallbackFailed record component

streamsIterationFailed - the value for the streamsIterationFailed record component

postTransactionOperationsRun - the value for the postTransactionOperationsRun record component

postTransactionOperationsFailed - the value for the postTransactionOperationsFailed record component

Method Details

toString

public final String toString()

Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.

Specified by:

toString in class Record

Returns:

a string representation of this object

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

connectionsAcquiredStatementScope

public @NonNull Long connectionsAcquiredStatementScope()

Returns the value of the connectionsAcquiredStatementScope record component.

Returns:

the value of the connectionsAcquiredStatementScope record component

connectionsAcquiredTransactionScope

public @NonNull Long connectionsAcquiredTransactionScope()

Returns the value of the connectionsAcquiredTransactionScope record component.

Returns:

the value of the connectionsAcquiredTransactionScope record component

connectionsFailedStatementScope

public @NonNull Long connectionsFailedStatementScope()

Returns the value of the connectionsFailedStatementScope record component.

Returns:

the value of the connectionsFailedStatementScope record component

connectionsFailedTransactionScope

public @NonNull Long connectionsFailedTransactionScope()

Returns the value of the connectionsFailedTransactionScope record component.

Returns:

the value of the connectionsFailedTransactionScope record component

connectionReleaseFailuresStatementScope

public @NonNull Long connectionReleaseFailuresStatementScope()

Returns the value of the connectionReleaseFailuresStatementScope record component.

Returns:

the value of the connectionReleaseFailuresStatementScope record component

connectionReleaseFailuresTransactionScope

public @NonNull Long connectionReleaseFailuresTransactionScope()

Returns the value of the connectionReleaseFailuresTransactionScope record component.

Returns:

the value of the connectionReleaseFailuresTransactionScope record component

transactionClosuresEntered

public @NonNull Long transactionClosuresEntered()

Returns the value of the transactionClosuresEntered record component.

Returns:

the value of the transactionClosuresEntered record component

transactionClosuresExited

public @NonNull Long transactionClosuresExited()

Returns the value of the transactionClosuresExited record component.

Returns:

the value of the transactionClosuresExited record component

transactionClosuresCommitted

public @NonNull Long transactionClosuresCommitted()

Returns the value of the transactionClosuresCommitted record component.

Returns:

the value of the transactionClosuresCommitted record component

transactionClosuresRolledBack

public @NonNull Long transactionClosuresRolledBack()

Returns the value of the transactionClosuresRolledBack record component.

Returns:

the value of the transactionClosuresRolledBack record component

transactionClosuresNoPhysical

public @NonNull Long transactionClosuresNoPhysical()

Returns the value of the transactionClosuresNoPhysical record component.

Returns:

the value of the transactionClosuresNoPhysical record component

transactionClosuresFailed

public @NonNull Long transactionClosuresFailed()

Returns the value of the transactionClosuresFailed record component.

Returns:

the value of the transactionClosuresFailed record component

physicalTransactionsBegun

public @NonNull Long physicalTransactionsBegun()

Returns the value of the physicalTransactionsBegun record component.

Returns:

the value of the physicalTransactionsBegun record component

physicalTransactionsBeginFailed

public @NonNull Long physicalTransactionsBeginFailed()

Returns the value of the physicalTransactionsBeginFailed record component.

Returns:

the value of the physicalTransactionsBeginFailed record component

physicalTransactionsCommitted

public @NonNull Long physicalTransactionsCommitted()

Returns the value of the physicalTransactionsCommitted record component.

Returns:

the value of the physicalTransactionsCommitted record component

physicalTransactionsCommitFailed

public @NonNull Long physicalTransactionsCommitFailed()

Returns the value of the physicalTransactionsCommitFailed record component.

Returns:

the value of the physicalTransactionsCommitFailed record component

physicalTransactionsRolledBack

public @NonNull Long physicalTransactionsRolledBack()

Returns the value of the physicalTransactionsRolledBack record component.

Returns:

the value of the physicalTransactionsRolledBack record component

physicalTransactionsRollbackFailed

public @NonNull Long physicalTransactionsRollbackFailed()

Returns the value of the physicalTransactionsRollbackFailed record component.

Returns:

the value of the physicalTransactionsRollbackFailed record component

savepointsCreated

public @NonNull Long savepointsCreated()

Returns the value of the savepointsCreated record component.

Returns:

the value of the savepointsCreated record component

savepointsRolledBack

public @NonNull Long savepointsRolledBack()

Returns the value of the savepointsRolledBack record component.

Returns:

the value of the savepointsRolledBack record component

savepointsReleased

public @NonNull Long savepointsReleased()

Returns the value of the savepointsReleased record component.

Returns:

the value of the savepointsReleased record component

statementsExecuted

public @NonNull Long statementsExecuted()

Returns the value of the statementsExecuted record component.

Returns:

the value of the statementsExecuted record component

statementsFailed

public @NonNull Long statementsFailed()

Returns the value of the statementsFailed record component.

Returns:

the value of the statementsFailed record component

streamsOpened

public @NonNull Long streamsOpened()

Returns the value of the streamsOpened record component.

Returns:

the value of the streamsOpened record component

streamsOpenFailures

public @NonNull Long streamsOpenFailures()

Returns the value of the streamsOpenFailures record component.

Returns:

the value of the streamsOpenFailures record component

streamsClosedNormally

public @NonNull Long streamsClosedNormally()

Returns the value of the streamsClosedNormally record component.

Returns:

the value of the streamsClosedNormally record component

streamsEarlyClosed

public @NonNull Long streamsEarlyClosed()

Returns the value of the streamsEarlyClosed record component.

Returns:

the value of the streamsEarlyClosed record component

streamsCallbackFailed

public @NonNull Long streamsCallbackFailed()

Returns the value of the streamsCallbackFailed record component.

Returns:

the value of the streamsCallbackFailed record component

streamsIterationFailed

public @NonNull Long streamsIterationFailed()

Returns the value of the streamsIterationFailed record component.

Returns:

the value of the streamsIterationFailed record component

postTransactionOperationsRun

public @NonNull Long postTransactionOperationsRun()

Returns the value of the postTransactionOperationsRun record component.

Returns:

the value of the postTransactionOperationsRun record component

postTransactionOperationsFailed

public @NonNull Long postTransactionOperationsFailed()

Returns the value of the postTransactionOperationsFailed record component.

Returns:

the value of the postTransactionOperationsFailed record component