Interface LogMinerStreamingChangeEventSourceMetricsMXBean
- All Superinterfaces:
ChangeEventSourceMetricsMXBean,CommonEventMetricsMXBean,ConnectionMetricsMXBean,OracleCommonStreamingChangeEventSourceMetricsMXBean,QueueMetricsMXBean,SchemaMetricsMXBean,StreamingChangeEventSourceMetricsMXBean,StreamingMetricsMXBean
- All Known Implementing Classes:
LogMinerStreamingChangeEventSourceMetrics
public interface LogMinerStreamingChangeEventSourceMetricsMXBean
extends OracleCommonStreamingChangeEventSourceMetricsMXBean
Oracle Streaming Metrics for Oracle LogMiner.
- Author:
- Chris Cranford
-
Method Summary
Modifier and TypeMethodDescriptionlongintSpecifies the maximum gap between the start and end system change number range used for querying changes from LogMiner.Oracle maintains two watermarks, a low and high system change number watermark.longString[]default String[]Deprecated.default longDeprecated.to be removed in Debezium 2.7, replaced bygetFetchQueryCount()longdefault intDeprecated.to be removed in Debezium 2.7, replaced bygetMillisecondsToKeepTransactionsInBuffer()longReturns the time in milliseconds between when the database captured the change and when the change is placed into the transaction buffer by the connector.longlonglonglonglongintlonglonglonglonglonglongReturns 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.longlongSpecifies the number of milliseconds that transactions are retained in the transaction buffer before the connector discards them due to their age.default longDeprecated.to be removed in Debezium 2.7, replaced bygetSleepTimeInMilliseconds()longlonglonglonglonglonglongReturns 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.default longDeprecated.to be removed in Debezium 2.7 with no replacementlonglonglongOracle maintains two watermarks, a low and high system change number watermark.longdefault String[]Deprecated.to be removed in Debezium 2.7, replaced bygetRedoLogStatuses()String[]Exposes states of redo logs: current, active, inactive, unused ...default longDeprecated.to be removed in Debezium 2.7, replaced bygetTotalChangesCount()longlongdefault intDeprecated.to be removed in Debezium 2.7, replaced bygetLogSwitchCount()longlonglonglonglongdefault longDeprecated.to be removed in Debezium 2.7, replaced bygetTotalBatchProcessingTimeInMilliseconds()longEach 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.Methods inherited from interface io.debezium.pipeline.metrics.ChangeEventSourceMetricsMXBean
resetMethods inherited from interface io.debezium.pipeline.metrics.traits.CommonEventMetricsMXBean
getLastEvent, getMilliSecondsSinceLastEvent, getNumberOfErroneousEvents, getNumberOfEventsFiltered, getTotalNumberOfCreateEventsSeen, getTotalNumberOfDeleteEventsSeen, getTotalNumberOfEventsSeen, getTotalNumberOfUpdateEventsSeenMethods inherited from interface io.debezium.pipeline.metrics.traits.ConnectionMetricsMXBean
isConnectedMethods inherited from interface io.debezium.connector.oracle.OracleCommonStreamingChangeEventSourceMetricsMXBean
getErrorCount, getLastCapturedDmlCount, getMaxCapturedDmlCountInBatch, getMaxCapturedDmlInBatch, getTotalCapturedDmlCount, getTotalSchemaChangeParseErrorCount, getUnparsableDdlCount, getWarningCountMethods inherited from interface io.debezium.pipeline.metrics.traits.QueueMetricsMXBean
getCurrentQueueSizeInBytes, getMaxQueueSizeInBytes, getQueueRemainingCapacity, getQueueTotalCapacityMethods inherited from interface io.debezium.pipeline.metrics.traits.SchemaMetricsMXBean
getCapturedTablesMethods inherited from interface io.debezium.pipeline.metrics.traits.StreamingMetricsMXBean
getLastTransactionId, getMilliSecondsBehindSource, getNumberOfCommittedTransactions, getSourceEventPosition
-
Method Details
-
getCurrentRedoLogFileName
Deprecated.to be removed in Debezium 2.7, replaced bygetCurrentLogFileNames()- Returns:
- array of currently mined log files
-
getRedoLogStatus
Deprecated.to be removed in Debezium 2.7, replaced bygetRedoLogStatuses()- Returns:
- array of log files and their respective statues in Oracle
-
getSwitchCounter
Deprecated.to be removed in Debezium 2.7, replaced bygetLogSwitchCount()- Returns:
- number of log switches observed in the last day
-
getFetchingQueryCount
Deprecated.to be removed in Debezium 2.7, replaced bygetFetchQueryCount()- Returns:
- number of LogMiner queries executed by the connector
-
getHoursToKeepTransactionInBuffer
Deprecated.to be removed in Debezium 2.7, replaced bygetMillisecondsToKeepTransactionsInBuffer()- Returns:
- duration in hours that transactions are retained in the transaction buffer
-
getTotalProcessingTimeInMilliseconds
Deprecated.to be removed in Debezium 2.7, replaced bygetTotalBatchProcessingTimeInMilliseconds()- Returns:
- total duration in milliseconds for processing all LogMiner query batches
-
getRegisteredDmlCount
Deprecated.to be removed in Debezium 2.7, replaced bygetTotalChangesCount()- Returns:
- total number of change events
-
getMillisecondsToSleepBetweenMiningQuery
Deprecated.to be removed in Debezium 2.7, replaced bygetSleepTimeInMilliseconds()- Returns:
- number of milliseconds to sleep between each LogMiner query
-
getNetworkConnectionProblemsCounter
Deprecated.to be removed in Debezium 2.7 with no replacement- Specified by:
getNetworkConnectionProblemsCounterin interfaceOracleCommonStreamingChangeEventSourceMetricsMXBean- Returns:
- total number of network problems
-
getMillisecondsToKeepTransactionsInBuffer
long getMillisecondsToKeepTransactionsInBuffer()Specifies the number of milliseconds that transactions are retained in the transaction buffer before the connector discards them due to their age. When set to0, transactions are retained until they are either committed or rolled back.- Returns:
- number of milliseconds that transactions are buffered before being discarded
-
getSleepTimeInMilliseconds
long getSleepTimeInMilliseconds()- Returns:
- number of milliseconds that the connector sleeps between LogMiner queries
-
getCurrentScn
BigInteger getCurrentScn()- Returns:
- the current system change number of the database
-
getOffsetScn
BigInteger getOffsetScn()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.- Returns:
- the system change number where the connector will start from on restarts
-
getCommittedScn
BigInteger getCommittedScn()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.- Returns:
- the system change number where the connector last observed a commit
-
getOldestScn
BigInteger getOldestScn()- Returns:
- oldest system change number currently in the transaction buffer
-
getOldestScnAgeInMilliseconds
long getOldestScnAgeInMilliseconds()- Returns:
- age in milliseconds of the oldest system change number in the transaction buffer
-
getCurrentLogFileNames
String[] getCurrentLogFileNames()- Returns:
- array of current filenames to be used by the mining session
-
getBatchSize
int getBatchSize()Specifies the maximum gap between the start and end system change number range used for querying changes from LogMiner.- Returns:
- the LogMiner query batch size
-
getMinimumMinedLogCount
long getMinimumMinedLogCount()- Returns:
- the minimum number of logs used by a mining session
-
getMaximumMinedLogCount
long getMaximumMinedLogCount()- Returns:
- the maximum number of logs used by a mining session
-
getRedoLogStatuses
String[] getRedoLogStatuses()Exposes states of redo logs: current, active, inactive, unused ...- Returns:
- array of: (redo log name | status) elements
-
getLogSwitchCount
int getLogSwitchCount()- Returns:
- the number of redo log switches for the current day
-
getTotalProcessedRows
long getTotalProcessedRows()- Returns:
- the total number of database rows processed from LogMiner
-
getNumberOfActiveTransactions
long getNumberOfActiveTransactions()- Returns:
- number of current active transactions in the transaction buffer
-
getNumberOfRolledBackTransactions
long getNumberOfRolledBackTransactions()- Returns:
- number of transactions seen that were rolled back
-
getNumberOfOversizedTransactions
long getNumberOfOversizedTransactions()- Returns:
- number of discarded transactions due to exceeding max event size
-
getTotalChangesCount
long getTotalChangesCount()- Returns:
- total number of changes seen by the connector.
-
getFetchQueryCount
long getFetchQueryCount()- Returns:
- number of LogMiner queries executed.
-
getScnFreezeCount
long getScnFreezeCount()- Returns:
- number of times the system change number does not change over consecutive LogMiner queries
-
getLastDurationOfFetchQueryInMilliseconds
long getLastDurationOfFetchQueryInMilliseconds()- Returns:
- duration of the last LogMiner query execution in milliseconds
-
getMaxDurationOfFetchQueryInMilliseconds
long getMaxDurationOfFetchQueryInMilliseconds()- Returns:
- maximum duration across all LogMiner queries executed in milliseconds
-
getLastBatchProcessingTimeInMilliseconds
long getLastBatchProcessingTimeInMilliseconds()- Returns:
- duration for processing the results of the last LogMiner query in milliseconds
-
getMinBatchProcessingTimeInMilliseconds
long getMinBatchProcessingTimeInMilliseconds()- Returns:
- minimum duration in milliseconds for processing results from a LogMiner query
-
getMaxBatchProcessingTimeInMilliseconds
long getMaxBatchProcessingTimeInMilliseconds()- Returns:
- maximum duration in milliseconds for processing results from a LogMiner query
-
getTotalBatchProcessingTimeInMilliseconds
long getTotalBatchProcessingTimeInMilliseconds()- Returns:
- total duration in milliseconds for processing results for all LogMiner queries
-
getCommitThroughput
long getCommitThroughput()- Returns:
- average number of committed transactions per second in the transaction buffer
-
getLastBatchProcessingThroughput
long getLastBatchProcessingThroughput()- Returns:
- throughput per second for last LogMiner session
-
getMaxBatchProcessingThroughput
long getMaxBatchProcessingThroughput()- Returns:
- maximum throughput per second across all LogMiner sessions
-
getAverageBatchProcessingThroughput
long getAverageBatchProcessingThroughput()- Returns:
- average throughput per second across all LogMiner sessions
-
getLastCommitDurationInMilliseconds
long getLastCommitDurationInMilliseconds()- Returns:
- duration for processing the last transaction commit in milliseconds
-
getMaxCommitDurationInMilliseconds
long getMaxCommitDurationInMilliseconds()- Returns:
- maximum duration for processing a transaction commit in milliseconds
-
getLastMiningSessionStartTimeInMilliseconds
long getLastMiningSessionStartTimeInMilliseconds()- Returns:
- duration in milliseconds for the last LogMiner session start-up and data dictionary load
-
getMaxMiningSessionStartTimeInMilliseconds
long getMaxMiningSessionStartTimeInMilliseconds()- Returns:
- maximum duration in milliseconds for a LogMiner session start-up and data dictionary load
-
getTotalMiningSessionStartTimeInMilliseconds
long getTotalMiningSessionStartTimeInMilliseconds()- Returns:
- total duration in milliseconds for all LogMiner session start-ups and data dictionary loads
-
getTotalParseTimeInMilliseconds
long getTotalParseTimeInMilliseconds()- Returns:
- total duration in milliseconds for parsing SQL statements
-
getTotalResultSetNextTimeInMilliseconds
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. This metric tracks the total time spent in milliseconds for this particular call over the lifetime of the connector.- Returns:
- total duration in milliseconds for all
ResultSet#nextcalls
-
getLagFromSourceInMilliseconds
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.- Returns:
- duration of the lag from the source database in milliseconds
-
getMinLagFromSourceInMilliseconds
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.- Returns:
- minimum duration of the lag from the source database in milliseconds
-
getMaxLagFromSourceInMilliseconds
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.- Returns:
- maximum duration of the lag from the source database in milliseconds
-
getMiningSessionUserGlobalAreaMemoryInBytes
long getMiningSessionUserGlobalAreaMemoryInBytes()- Returns:
- the current mining session's UGA memory usage in bytes.
-
getMiningSessionUserGlobalAreaMaxMemoryInBytes
long getMiningSessionUserGlobalAreaMaxMemoryInBytes()- Returns:
- the current mining session's UGA maximum memory usage in bytes.
-
getMiningSessionProcessGlobalAreaMemoryInBytes
long getMiningSessionProcessGlobalAreaMemoryInBytes()- Returns:
- the current mining session's PGA memory usage in bytes.
-
getMiningSessionProcessGlobalAreaMaxMemoryInBytes
long getMiningSessionProcessGlobalAreaMaxMemoryInBytes()- Returns:
- the current mining session's PGA maximum memory usage in bytes.
-
getAbandonedTransactionIds
- Returns:
- most recent transaction identifiers that were abandoned
-
getRolledBackTransactionIds
- Returns:
- most recent transaction identifiers that were rolled back
-
getCurrentLogFileNames()