Package io.debezium.connector.oracle.logminer

Class LogMinerStreamingChangeEventSourceMetrics

java.lang.Object

io.debezium.metrics.Metrics

io.debezium.pipeline.metrics.PipelineMetrics<P>

io.debezium.pipeline.metrics.DefaultStreamingChangeEventSourceMetrics<OraclePartition>

io.debezium.connector.oracle.AbstractOracleStreamingChangeEventSourceMetrics

io.debezium.connector.oracle.logminer.LogMinerStreamingChangeEventSourceMetrics

All Implemented Interfaces:

LogMinerStreamingChangeEventSourceMetricsMXBean, OracleCommonStreamingChangeEventSourceMetricsMXBean, ChangeEventSourceMetrics<OraclePartition>, ChangeEventSourceMetricsMXBean, StreamingChangeEventSourceMetrics<OraclePartition>, StreamingChangeEventSourceMetricsMXBean, CommonEventMetricsMXBean, ConnectionMetricsMXBean, QueueMetricsMXBean, SchemaMetricsMXBean, StreamingMetricsMXBean, DataChangeEventListener<OraclePartition>, StreamingProgressListener

@ThreadSafe
public class LogMinerStreamingChangeEventSourceMetrics
extends AbstractOracleStreamingChangeEventSourceMetrics
implements LogMinerStreamingChangeEventSourceMetricsMXBean

Oracle Streaming Metrics implementation for the Oracle LogMiner streaming adapter.

Author:

Chris Cranford

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	Utility class for tracking histogram-based values for a duration-based metric.
(package private) static class	LogMinerStreamingChangeEventSourceMetrics.LRUSet<T>	Utility class for maintaining a least-recently-used list of values.
(package private) static class	LogMinerStreamingChangeEventSourceMetrics.MaxLongValueMetric	Utility class for tracking the current and maximum long value.

Field Summary

Fields

Modifier and Type	Field	Description
private final LogMinerStreamingChangeEventSourceMetrics.LRUSet<String>	abandonedTransactionIds
private final AtomicLong	activeTransactionCount
private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	batchProcessingDuration
private final AtomicInteger	batchSize
private final AtomicLong	changesCount
private final Clock	clock
private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	commitDuration
private final AtomicReference<Scn>	commitScn
private final OracleConnectorConfig	connectorConfig
private final AtomicReference<String[]>	currentLogFileNames
private final AtomicReference<Scn>	currentScn
private final AtomicReference<ZoneOffset>	databaseZoneOffset
private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	fetchQueryDuration
private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	lagFromSourceDuration
private static final org.slf4j.Logger	LOGGER
private final AtomicInteger	logMinerQueryCount
private final AtomicInteger	logSwitchCount
private final AtomicLong	maxBatchProcessingThroughput
private final AtomicLong	maximumLogsMined
private static final long	MILLIS_PER_SECOND
private final AtomicLong	minimumLogsMined
private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	miningSessionStartupDuration
private final AtomicReference<Scn>	offsetScn
private final AtomicReference<Scn>	oldestScn
private final AtomicReference<Instant>	oldestScnTime
private final AtomicLong	oversizedTransactionCount
private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	parseTimeDuration
private final AtomicLong	processedRowsCount
private final LogMinerStreamingChangeEventSourceMetrics.MaxLongValueMetric	processGlobalAreaMemory
private final AtomicReference<String[]>	redoLogStatuses
private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric	resultSetNextDuration
private final AtomicLong	rolledBackTransactionCount
private final LogMinerStreamingChangeEventSourceMetrics.LRUSet<String>	rolledBackTransactionIds
private final AtomicLong	scnFreezeCount
private final AtomicLong	sleepTime
private final Instant	startTime
private final AtomicLong	timeDifference
private static final int	TRANSACTION_ID_SET_SIZE
private final LogMinerStreamingChangeEventSourceMetrics.MaxLongValueMetric	userGlobalAreaMemory

Fields inherited from class io.debezium.pipeline.metrics.PipelineMetrics

metadataProvider, taskContext

Constructor Summary

Constructors

Constructor	Description
LogMinerStreamingChangeEventSourceMetrics(CdcSourceTaskContext taskContext, ChangeEventQueueMetrics changeEventQueueMetrics, EventMetadataProvider metadataProvider, OracleConnectorConfig connectorConfig)
LogMinerStreamingChangeEventSourceMetrics(CdcSourceTaskContext taskContext, ChangeEventQueueMetrics changeEventQueueMetrics, EventMetadataProvider metadataProvider, OracleConnectorConfig connectorConfig, Clock clock)

Method Summary

Modifier and Type	Method	Description
void	addAbandonedTransactionId(String transactionId)	Add a transaction to the recently tracked abandoned transactions metric.
void	addRolledBackTransactionId(String transactionId)	Add a transaction to the recently rolled back transactions metric.
void	calculateLagFromSource(Instant changeTime)	Calculates the lag metrics based on the provided event's database change time.
long	getAbandonedTransactionCount()
Set<String>	getAbandonedTransactionIds()
long	getAverageBatchProcessingThroughput()
int	getBatchSize()	Specifies the maximum gap between the start and end system change number range used for querying changes from LogMiner.
BigInteger	getCommittedScn()	Oracle maintains two watermarks, a low and high system change number watermark.
long	getCommitThroughput()
String[]	getCurrentLogFileNames()
BigInteger	getCurrentScn()
ZoneOffset	getDatabaseOffset()
long	getFetchQueryCount()
long	getLagFromSourceInMilliseconds()	Returns the time in milliseconds between when the database captured the change and when the change is placed into the transaction buffer by the connector.
long	getLastBatchProcessingThroughput()
long	getLastBatchProcessingTimeInMilliseconds()
long	getLastCommitDurationInMilliseconds()
long	getLastDurationOfFetchQueryInMilliseconds()
long	getLastMiningSessionStartTimeInMilliseconds()
int	getLogSwitchCount()
long	getMaxBatchProcessingThroughput()
long	getMaxBatchProcessingTimeInMilliseconds()
long	getMaxCommitDurationInMilliseconds()
long	getMaxDurationOfFetchQueryInMilliseconds()
long	getMaximumMinedLogCount()
long	getMaxLagFromSourceInMilliseconds()	Returns the maximum time difference in milliseconds between the database capture time and the time when the event is placed into the transaction buffer by the connector.
long	getMaxMiningSessionStartTimeInMilliseconds()
long	getMillisecondsToKeepTransactionsInBuffer()	Specifies the number of milliseconds that transactions are retained in the transaction buffer before the connector discards them due to their age.
long	getMinBatchProcessingTimeInMilliseconds()
long	getMinimumMinedLogCount()
long	getMiningSessionProcessGlobalAreaMaxMemoryInBytes()
long	getMiningSessionProcessGlobalAreaMemoryInBytes()
long	getMiningSessionUserGlobalAreaMaxMemoryInBytes()
long	getMiningSessionUserGlobalAreaMemoryInBytes()
long	getMinLagFromSourceInMilliseconds()	Returns the minimum time difference in milliseconds between the database capture time and the time when the event is placed into the transaction buffer by the connector.
long	getNumberOfActiveTransactions()
long	getNumberOfOversizedTransactions()
long	getNumberOfRolledBackTransactions()
BigInteger	getOffsetScn()	Oracle maintains two watermarks, a low and high system change number watermark.
BigInteger	getOldestScn()
long	getOldestScnAgeInMilliseconds()
String[]	getRedoLogStatuses()	Exposes states of redo logs: current, active, inactive, unused ...
Set<String>	getRolledBackTransactionIds()
long	getScnFreezeCount()
long	getSleepTimeInMilliseconds()
long	getTotalBatchProcessingTimeInMilliseconds()
long	getTotalChangesCount()
long	getTotalMiningSessionStartTimeInMilliseconds()
long	getTotalParseTimeInMilliseconds()
long	getTotalProcessedRows()
long	getTotalResultSetNextTimeInMilliseconds()	Each time a row is processed, the connector makes a call to the underlying JDBC driver to fetch the next row and sometimes this fetch may need to make a round-trip to the database to get the next batch of rows.
void	incrementLogMinerQueryCount()	Increments the number of LogMiner queries executed.
void	incrementOversizedTransactionCount()	Increments the number of over-sized transactions.
void	incrementRolledBackTransactionCount()	Increments the number of rolled back transactions.
void	incrementScnFreezeCount()	Increments the number of times the system change number is considered frozen and has not changed over several consecutive LogMiner query batches.
void	incrementTotalChangesCount()	Increments the total changes seen.
void	reset()
void	setActiveTransactionCount(long activeTransactionCount)	Sets the number of current, active transactions in the transaction buffer.
void	setBatchSize(int batchSize)	Set the currently used batch size for querying LogMiner.
void	setCommitScn(Scn commitScn)	Sets the offset's high-watermark system change number.
void	setCurrentLogFileNames(Set<String> logFileNames)	Set the current iteration's logs that are being mined.
void	setCurrentScn(Scn currentScn)	Set the current system change number from the database.
void	setDatabaseTimeDifference(OffsetDateTime databaseSystemTime)	Sets the database time zone and calculates the difference in time between the database server and the connector.
void	setLastBatchProcessingDuration(Duration duration)	Sets the duration of the total processing of the last LogMiner query result-set.
void	setLastCommitDuration(Duration duration)	Sets the duration of the last transaction commit processing.
void	setLastDurationOfFetchQuery(Duration duration)	Sets the duration of the last LogMiner query execution.
void	setLastMiningSessionStartDuration(Duration duration)	Sets the duration of the last LogMiner mining session start-up and data dictionary load.
void	setLastParseTimeDuration(Duration duration)	Sets the duration for parsing the last SQL statement.
void	setLastProcessedRowsCount(long processedRowsCount)	Sets the last number of rows processed by the LogMiner mining iteration.
void	setLastResultSetNextDuration(Duration duration)	Sets the duration for the last ResultSet#next function call.
void	setOffsetScn(Scn offsetScn)	Set the offset's low-watermark system change number.
void	setOldestScnDetails(Scn oldestScn, Instant changeTime)	Sets the details for the oldest system change number in the transaction buffer.
void	setProcessGlobalAreaMemory(long memory, long maxMemory)	Set the database's current process global area (PGA) memory statistics.
void	setRedoLogStatuses(Map<String,String> statuses)	Set the current logs and their respective statuses.
void	setScnFreezeCount(long scnFreezeCount)	Sets the number of times the system change number is considered frozen and has not changed over several consecutive LogMiner query batches.
void	setSleepTime(long sleepTime)	Set the connector's currently used sleep/pause time between LogMiner queries.
void	setSwitchCount(int logSwitchCount)	Set the number of log switches in the past day.
void	setUserGlobalAreaMemory(long memory, long maxMemory)	Set the database's current user global area (UGA) memory statistics.
String	toString()

Methods inherited from class io.debezium.connector.oracle.AbstractOracleStreamingChangeEventSourceMetrics

getErrorCount, getLastCapturedDmlCount, getMaxCapturedDmlCountInBatch, getNumberOfCommittedTransactions, getTotalCapturedDmlCount, getTotalSchemaChangeParseErrorCount, getWarningCount, incrementCommittedTransactionCount, incrementErrorCount, incrementSchemaChangeParseErrorCount, incrementWarningCount, setLastCapturedDmlCount

Methods inherited from class io.debezium.pipeline.metrics.DefaultStreamingChangeEventSourceMetrics

connected, getCapturedTables, getLastTransactionId, getMilliSecondsBehindSource, getSourceEventPosition, isConnected, onConnectorEvent, onEvent

Methods inherited from class io.debezium.pipeline.metrics.PipelineMetrics

getCurrentQueueSizeInBytes, getLastEvent, getMaxQueueSizeInBytes, getMilliSecondsSinceLastEvent, getNumberOfErroneousEvents, getNumberOfEventsFiltered, getQueueRemainingCapacity, getQueueTotalCapacity, getTotalNumberOfCreateEventsSeen, getTotalNumberOfDeleteEventsSeen, getTotalNumberOfEventsSeen, getTotalNumberOfUpdateEventsSeen, onErroneousEvent, onErroneousEvent, onFilteredEvent, onFilteredEvent

Methods inherited from class io.debezium.metrics.Metrics

metricName, metricName, register, unregister

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.debezium.pipeline.metrics.ChangeEventSourceMetrics

register, unregister

Methods inherited from interface io.debezium.pipeline.metrics.traits.CommonEventMetricsMXBean

getLastEvent, getMilliSecondsSinceLastEvent, getNumberOfErroneousEvents, getNumberOfEventsFiltered, getTotalNumberOfCreateEventsSeen, getTotalNumberOfDeleteEventsSeen, getTotalNumberOfEventsSeen, getTotalNumberOfUpdateEventsSeen

Methods inherited from interface io.debezium.pipeline.metrics.traits.ConnectionMetricsMXBean

isConnected

Methods inherited from interface io.debezium.pipeline.source.spi.DataChangeEventListener

onErroneousEvent, onErroneousEvent, onFilteredEvent, onFilteredEvent

Methods inherited from interface io.debezium.connector.oracle.logminer.LogMinerStreamingChangeEventSourceMetricsMXBean

getCurrentRedoLogFileName, getFetchingQueryCount, getHoursToKeepTransactionInBuffer, getMillisecondsToSleepBetweenMiningQuery, getNetworkConnectionProblemsCounter, getRedoLogStatus, getRegisteredDmlCount, getSwitchCounter, getTotalProcessingTimeInMilliseconds

Methods inherited from interface io.debezium.connector.oracle.OracleCommonStreamingChangeEventSourceMetricsMXBean

getErrorCount, getLastCapturedDmlCount, getMaxCapturedDmlCountInBatch, getMaxCapturedDmlInBatch, getTotalCapturedDmlCount, getTotalSchemaChangeParseErrorCount, getUnparsableDdlCount, getWarningCount

Methods inherited from interface io.debezium.pipeline.metrics.traits.QueueMetricsMXBean

getCurrentQueueSizeInBytes, getMaxQueueSizeInBytes, getQueueRemainingCapacity, getQueueTotalCapacity

Methods inherited from interface io.debezium.pipeline.metrics.traits.SchemaMetricsMXBean

getCapturedTables

Methods inherited from interface io.debezium.pipeline.metrics.traits.StreamingMetricsMXBean

getLastTransactionId, getMilliSecondsBehindSource, getNumberOfCommittedTransactions, getSourceEventPosition

Field Details

LOGGER

private static final org.slf4j.Logger LOGGER

MILLIS_PER_SECOND

private static final long MILLIS_PER_SECOND

See Also:

• Constant Field Values

TRANSACTION_ID_SET_SIZE

private static final int TRANSACTION_ID_SET_SIZE

See Also:

• Constant Field Values

connectorConfig

private final OracleConnectorConfig connectorConfig

startTime

private final Instant startTime

clock

private final Clock clock

currentScn

private final AtomicReference<Scn> currentScn

offsetScn

private final AtomicReference<Scn> offsetScn

commitScn

private final AtomicReference<Scn> commitScn

oldestScn

private final AtomicReference<Scn> oldestScn

oldestScnTime

private final AtomicReference<Instant> oldestScnTime

currentLogFileNames

private final AtomicReference<String[]> currentLogFileNames

redoLogStatuses

private final AtomicReference<String[]> redoLogStatuses

databaseZoneOffset

private final AtomicReference<ZoneOffset> databaseZoneOffset

batchSize

private final AtomicInteger batchSize

logSwitchCount

private final AtomicInteger logSwitchCount

logMinerQueryCount

private final AtomicInteger logMinerQueryCount

sleepTime

private final AtomicLong sleepTime

minimumLogsMined

private final AtomicLong minimumLogsMined

maximumLogsMined

private final AtomicLong maximumLogsMined

maxBatchProcessingThroughput

private final AtomicLong maxBatchProcessingThroughput

timeDifference

private final AtomicLong timeDifference

processedRowsCount

private final AtomicLong processedRowsCount

activeTransactionCount

private final AtomicLong activeTransactionCount

rolledBackTransactionCount

private final AtomicLong rolledBackTransactionCount

oversizedTransactionCount

private final AtomicLong oversizedTransactionCount

changesCount

private final AtomicLong changesCount

scnFreezeCount

private final AtomicLong scnFreezeCount

batchProcessingDuration

private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric batchProcessingDuration

fetchQueryDuration

private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric fetchQueryDuration

commitDuration

private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric commitDuration

lagFromSourceDuration

private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric lagFromSourceDuration

miningSessionStartupDuration

private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric miningSessionStartupDuration

parseTimeDuration

private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric parseTimeDuration

resultSetNextDuration

private final LogMinerStreamingChangeEventSourceMetrics.DurationHistogramMetric resultSetNextDuration

userGlobalAreaMemory

private final LogMinerStreamingChangeEventSourceMetrics.MaxLongValueMetric userGlobalAreaMemory

processGlobalAreaMemory

private final LogMinerStreamingChangeEventSourceMetrics.MaxLongValueMetric processGlobalAreaMemory

abandonedTransactionIds

private final LogMinerStreamingChangeEventSourceMetrics.LRUSet<String> abandonedTransactionIds

rolledBackTransactionIds

private final LogMinerStreamingChangeEventSourceMetrics.LRUSet<String> rolledBackTransactionIds

Constructor Details

LogMinerStreamingChangeEventSourceMetrics

public LogMinerStreamingChangeEventSourceMetrics(CdcSourceTaskContext taskContext,
 ChangeEventQueueMetrics changeEventQueueMetrics,
 EventMetadataProvider metadataProvider,
 OracleConnectorConfig connectorConfig)

LogMinerStreamingChangeEventSourceMetrics

public LogMinerStreamingChangeEventSourceMetrics(CdcSourceTaskContext taskContext,
 ChangeEventQueueMetrics changeEventQueueMetrics,
 EventMetadataProvider metadataProvider,
 OracleConnectorConfig connectorConfig,
 Clock clock)

Method Details

reset

public void reset()

Specified by:

reset in interface ChangeEventSourceMetricsMXBean

Overrides:

reset in class AbstractOracleStreamingChangeEventSourceMetrics

getMillisecondsToKeepTransactionsInBuffer

public long getMillisecondsToKeepTransactionsInBuffer()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Specifies the number of milliseconds that transactions are retained in the transaction buffer before the connector discards them due to their age. When set to 0, transactions are retained until they are either committed or rolled back.

Specified by:

getMillisecondsToKeepTransactionsInBuffer in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

number of milliseconds that transactions are buffered before being discarded

getSleepTimeInMilliseconds

public long getSleepTimeInMilliseconds()

Specified by:

getSleepTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

number of milliseconds that the connector sleeps between LogMiner queries

getCurrentScn

public BigInteger getCurrentScn()

Specified by:

getCurrentScn in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the current system change number of the database

getOffsetScn

public BigInteger getOffsetScn()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Oracle maintains two watermarks, a low and high system change number watermark. The low watermark is the offset system change number, which represents the position in the logs where the connector will begin reading changes upon restart.

Specified by:

getOffsetScn in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the system change number where the connector will start from on restarts

getCommittedScn

public BigInteger getCommittedScn()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Oracle maintains two watermarks, a low and high system change number watermark. The high watermark is the commit system change number, which represents the position in the logs where the last transaction commit occurred. This system change number is used to avoid dispatching any transaction that committed before this system change number.

Specified by:

getCommittedScn in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the system change number where the connector last observed a commit

getOldestScn

public BigInteger getOldestScn()

Specified by:

getOldestScn in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

oldest system change number currently in the transaction buffer

getOldestScnAgeInMilliseconds

public long getOldestScnAgeInMilliseconds()

Specified by:

getOldestScnAgeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

age in milliseconds of the oldest system change number in the transaction buffer

getCurrentLogFileNames

public String[] getCurrentLogFileNames()

Specified by:

getCurrentLogFileNames in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

array of current filenames to be used by the mining session

getBatchSize

public int getBatchSize()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Specifies the maximum gap between the start and end system change number range used for querying changes from LogMiner.

Specified by:

getBatchSize in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the LogMiner query batch size

getMinimumMinedLogCount

public long getMinimumMinedLogCount()

Specified by:

getMinimumMinedLogCount in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the minimum number of logs used by a mining session

getMaximumMinedLogCount

public long getMaximumMinedLogCount()

Specified by:

getMaximumMinedLogCount in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the maximum number of logs used by a mining session

getRedoLogStatuses

public String[] getRedoLogStatuses()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Exposes states of redo logs: current, active, inactive, unused ...

Specified by:

getRedoLogStatuses in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

array of: (redo log name | status) elements

getLogSwitchCount

public int getLogSwitchCount()

Specified by:

getLogSwitchCount in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the number of redo log switches for the current day

getTotalProcessedRows

public long getTotalProcessedRows()

Specified by:

getTotalProcessedRows in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the total number of database rows processed from LogMiner

getNumberOfActiveTransactions

public long getNumberOfActiveTransactions()

Specified by:

getNumberOfActiveTransactions in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

number of current active transactions in the transaction buffer

getNumberOfRolledBackTransactions

public long getNumberOfRolledBackTransactions()

Specified by:

getNumberOfRolledBackTransactions in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

number of transactions seen that were rolled back

getNumberOfOversizedTransactions

public long getNumberOfOversizedTransactions()

Specified by:

getNumberOfOversizedTransactions in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

number of discarded transactions due to exceeding max event size

getTotalChangesCount

public long getTotalChangesCount()

Specified by:

getTotalChangesCount in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

total number of changes seen by the connector.

getFetchQueryCount

public long getFetchQueryCount()

Specified by:

getFetchQueryCount in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

number of LogMiner queries executed.

getScnFreezeCount

public long getScnFreezeCount()

Specified by:

getScnFreezeCount in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

number of times the system change number does not change over consecutive LogMiner queries

getLastDurationOfFetchQueryInMilliseconds

public long getLastDurationOfFetchQueryInMilliseconds()

Specified by:

getLastDurationOfFetchQueryInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

duration of the last LogMiner query execution in milliseconds

getMaxDurationOfFetchQueryInMilliseconds

public long getMaxDurationOfFetchQueryInMilliseconds()

Specified by:

getMaxDurationOfFetchQueryInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

maximum duration across all LogMiner queries executed in milliseconds

getLastBatchProcessingTimeInMilliseconds

public long getLastBatchProcessingTimeInMilliseconds()

Specified by:

getLastBatchProcessingTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

duration for processing the results of the last LogMiner query in milliseconds

getMinBatchProcessingTimeInMilliseconds

public long getMinBatchProcessingTimeInMilliseconds()

Specified by:

getMinBatchProcessingTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

minimum duration in milliseconds for processing results from a LogMiner query

getMaxBatchProcessingTimeInMilliseconds

public long getMaxBatchProcessingTimeInMilliseconds()

Specified by:

getMaxBatchProcessingTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

maximum duration in milliseconds for processing results from a LogMiner query

getTotalBatchProcessingTimeInMilliseconds

public long getTotalBatchProcessingTimeInMilliseconds()

Specified by:

getTotalBatchProcessingTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

total duration in milliseconds for processing results for all LogMiner queries

getCommitThroughput

public long getCommitThroughput()

Specified by:

getCommitThroughput in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

average number of committed transactions per second in the transaction buffer

getLastBatchProcessingThroughput

public long getLastBatchProcessingThroughput()

Specified by:

getLastBatchProcessingThroughput in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

throughput per second for last LogMiner session

getMaxBatchProcessingThroughput

public long getMaxBatchProcessingThroughput()

Specified by:

getMaxBatchProcessingThroughput in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

maximum throughput per second across all LogMiner sessions

getAverageBatchProcessingThroughput

public long getAverageBatchProcessingThroughput()

Specified by:

getAverageBatchProcessingThroughput in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

average throughput per second across all LogMiner sessions

getLastCommitDurationInMilliseconds

public long getLastCommitDurationInMilliseconds()

Specified by:

getLastCommitDurationInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

duration for processing the last transaction commit in milliseconds

getMaxCommitDurationInMilliseconds

public long getMaxCommitDurationInMilliseconds()

Specified by:

getMaxCommitDurationInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

maximum duration for processing a transaction commit in milliseconds

getLastMiningSessionStartTimeInMilliseconds

public long getLastMiningSessionStartTimeInMilliseconds()

Specified by:

getLastMiningSessionStartTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

duration in milliseconds for the last LogMiner session start-up and data dictionary load

getMaxMiningSessionStartTimeInMilliseconds

public long getMaxMiningSessionStartTimeInMilliseconds()

Specified by:

getMaxMiningSessionStartTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

maximum duration in milliseconds for a LogMiner session start-up and data dictionary load

getTotalMiningSessionStartTimeInMilliseconds

public long getTotalMiningSessionStartTimeInMilliseconds()

Specified by:

getTotalMiningSessionStartTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

total duration in milliseconds for all LogMiner session start-ups and data dictionary loads

getTotalParseTimeInMilliseconds

public long getTotalParseTimeInMilliseconds()

Specified by:

getTotalParseTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

total duration in milliseconds for parsing SQL statements

getTotalResultSetNextTimeInMilliseconds

public long getTotalResultSetNextTimeInMilliseconds()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Each time a row is processed, the connector makes a call to the underlying JDBC driver to fetch the next row and sometimes this fetch may need to make a round-trip to the database to get the next batch of rows. This metric tracks the total time spent in milliseconds for this particular call over the lifetime of the connector.

Specified by:

getTotalResultSetNextTimeInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

total duration in milliseconds for all ResultSet#next calls

getLagFromSourceInMilliseconds

public long getLagFromSourceInMilliseconds()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Returns the time in milliseconds between when the database captured the change and when the change is placed into the transaction buffer by the connector.

Specified by:

getLagFromSourceInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

duration of the lag from the source database in milliseconds

getMinLagFromSourceInMilliseconds

public long getMinLagFromSourceInMilliseconds()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Returns the minimum time difference in milliseconds between the database capture time and the time when the event is placed into the transaction buffer by the connector.

Specified by:

getMinLagFromSourceInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

minimum duration of the lag from the source database in milliseconds

getMaxLagFromSourceInMilliseconds

public long getMaxLagFromSourceInMilliseconds()

Description copied from interface: LogMinerStreamingChangeEventSourceMetricsMXBean

Returns the maximum time difference in milliseconds between the database capture time and the time when the event is placed into the transaction buffer by the connector.

Specified by:

getMaxLagFromSourceInMilliseconds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

maximum duration of the lag from the source database in milliseconds

getMiningSessionUserGlobalAreaMemoryInBytes

public long getMiningSessionUserGlobalAreaMemoryInBytes()

Specified by:

getMiningSessionUserGlobalAreaMemoryInBytes in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the current mining session's UGA memory usage in bytes.

getMiningSessionUserGlobalAreaMaxMemoryInBytes

public long getMiningSessionUserGlobalAreaMaxMemoryInBytes()

Specified by:

getMiningSessionUserGlobalAreaMaxMemoryInBytes in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the current mining session's UGA maximum memory usage in bytes.

getMiningSessionProcessGlobalAreaMemoryInBytes

public long getMiningSessionProcessGlobalAreaMemoryInBytes()

Specified by:

getMiningSessionProcessGlobalAreaMemoryInBytes in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the current mining session's PGA memory usage in bytes.

getMiningSessionProcessGlobalAreaMaxMemoryInBytes

public long getMiningSessionProcessGlobalAreaMaxMemoryInBytes()

Specified by:

getMiningSessionProcessGlobalAreaMaxMemoryInBytes in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

the current mining session's PGA maximum memory usage in bytes.

getAbandonedTransactionIds

public Set<String> getAbandonedTransactionIds()

Specified by:

getAbandonedTransactionIds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

most recent transaction identifiers that were abandoned

getAbandonedTransactionCount

public long getAbandonedTransactionCount()

Specified by:

getAbandonedTransactionCount in interface LogMinerStreamingChangeEventSourceMetricsMXBean

getRolledBackTransactionIds

public Set<String> getRolledBackTransactionIds()

Specified by:

getRolledBackTransactionIds in interface LogMinerStreamingChangeEventSourceMetricsMXBean

Returns:

most recent transaction identifiers that were rolled back

getDatabaseOffset

public ZoneOffset getDatabaseOffset()

Returns:

database current zone offset

setBatchSize

public void setBatchSize(int batchSize)

Set the currently used batch size for querying LogMiner.

Parameters:

batchSize - batch size used for querying LogMiner

setSleepTime

public void setSleepTime(long sleepTime)

Set the connector's currently used sleep/pause time between LogMiner queries.

Parameters:

sleepTime - sleep time between LogMiner queries

setCurrentScn

public void setCurrentScn(Scn currentScn)

Set the current system change number from the database.

Parameters:

currentScn - database current system change number

setOffsetScn

public void setOffsetScn(Scn offsetScn)

Set the offset's low-watermark system change number.

Parameters:

offsetScn - offset's restart system change number, i.e. scn attribute

setCommitScn

public void setCommitScn(Scn commitScn)

Sets the offset's high-watermark system change number.

Parameters:

commitScn - offset's commit system change number, i.e. commit_scn attribute

setOldestScnDetails

public void setOldestScnDetails(Scn oldestScn,
 Instant changeTime)

Sets the details for the oldest system change number in the transaction buffer.

Parameters:

oldestScn - oldest system change number

changeTime - time when the oldest system change number was created

setCurrentLogFileNames

public void setCurrentLogFileNames(Set<String> logFileNames)

Set the current iteration's logs that are being mined.

Parameters:

logFileNames - current set of logs that are part of the mining session.

setRedoLogStatuses

public void setRedoLogStatuses(Map<String,String> statuses)

Set the current logs and their respective statuses.

Parameters:

statuses - map of file names as key and the file's status as the value.

setSwitchCount

public void setSwitchCount(int logSwitchCount)

Set the number of log switches in the past day.

Parameters:

logSwitchCount - number of log switches

setLastProcessedRowsCount

public void setLastProcessedRowsCount(long processedRowsCount)

Sets the last number of rows processed by the LogMiner mining iteration.

Parameters:

processedRowsCount - number of rows processed in the last mining iteration

setActiveTransactionCount

public void setActiveTransactionCount(long activeTransactionCount)

Sets the number of current, active transactions in the transaction buffer.

Parameters:

activeTransactionCount - number of active transactions

incrementRolledBackTransactionCount

public void incrementRolledBackTransactionCount()

Increments the number of rolled back transactions.

incrementOversizedTransactionCount

public void incrementOversizedTransactionCount()

Increments the number of over-sized transactions.

incrementTotalChangesCount

public void incrementTotalChangesCount()

Increments the total changes seen.

incrementLogMinerQueryCount

public void incrementLogMinerQueryCount()

Increments the number of LogMiner queries executed.

incrementScnFreezeCount

public void incrementScnFreezeCount()

Increments the number of times the system change number is considered frozen and has not changed over several consecutive LogMiner query batches.

setScnFreezeCount

public void setScnFreezeCount(long scnFreezeCount)

Sets the number of times the system change number is considered frozen and has not changed over several consecutive LogMiner query batches.

Parameters:

scnFreezeCount - number of times the system change number is considered frozen

setLastDurationOfFetchQuery

public void setLastDurationOfFetchQuery(Duration duration)

Sets the duration of the last LogMiner query execution.

Parameters:

duration - duration of the last LogMiner query

setLastBatchProcessingDuration

public void setLastBatchProcessingDuration(Duration duration)

Sets the duration of the total processing of the last LogMiner query result-set.

Parameters:

duration - duration of the total processing of the last LogMiner query result-set

setLastCommitDuration

public void setLastCommitDuration(Duration duration)

Sets the duration of the last transaction commit processing.

Parameters:

duration - duration of the last transaction commit processing

setLastMiningSessionStartDuration

public void setLastMiningSessionStartDuration(Duration duration)

Sets the duration of the last LogMiner mining session start-up and data dictionary load.

Parameters:

duration - duration of the last LogMiner session start-up

setLastParseTimeDuration

public void setLastParseTimeDuration(Duration duration)

Sets the duration for parsing the last SQL statement.

Parameters:

duration - duration for parsing the last SQL statement

setLastResultSetNextDuration

public void setLastResultSetNextDuration(Duration duration)

Sets the duration for the last ResultSet#next function call.

Parameters:

duration - duration for the last result set next call

setUserGlobalAreaMemory

public void setUserGlobalAreaMemory(long memory,
 long maxMemory)

Set the database's current user global area (UGA) memory statistics.

Parameters:

memory - current user global area memory

maxMemory - maximum user global area memory

setProcessGlobalAreaMemory

public void setProcessGlobalAreaMemory(long memory,
 long maxMemory)

Set the database's current process global area (PGA) memory statistics.

Parameters:

memory - current process global area memory

maxMemory - maximum process global area memory

addAbandonedTransactionId

public void addAbandonedTransactionId(String transactionId)

Add a transaction to the recently tracked abandoned transactions metric.

Parameters:

transactionId - transaction identifier

addRolledBackTransactionId

public void addRolledBackTransactionId(String transactionId)

Add a transaction to the recently rolled back transactions metric.

Parameters:

transactionId - transaction identifier

setDatabaseTimeDifference

public void setDatabaseTimeDifference(OffsetDateTime databaseSystemTime)

Sets the database time zone and calculates the difference in time between the database server and the connector. These values are necessary to calculate lag metrics.

Parameters:

databaseSystemTime - the database SYSTIMESTAMP value

calculateLagFromSource

public void calculateLagFromSource(Instant changeTime)

Calculates the lag metrics based on the provided event's database change time.

Parameters:

changeTime - the change time when the database recorded the event

toString

public String toString()

Overrides:

toString in class Object