Package io.debezium.connector.oracle

Class OracleStreamingChangeEventSourceMetrics

java.lang.Object

io.debezium.metrics.Metrics

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

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

io.debezium.connector.oracle.OracleStreamingChangeEventSourceMetrics

All Implemented Interfaces:

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

@ThreadSafe
public class OracleStreamingChangeEventSourceMetrics
extends DefaultStreamingChangeEventSourceMetrics<OraclePartition>
implements OracleStreamingChangeEventSourceMetricsMXBean

The metrics implementation for Oracle connector streaming phase.

Field Summary

Fields

Modifier and Type	Field	Description
private final AtomicReference<LRUCacheMap<String,String>>	abandonedTransactionIds
private final AtomicLong	activeTransactions
private final AtomicInteger	batchSize
private final int	batchSizeDefault
private final int	batchSizeMax
private final int	batchSizeMin
private final Clock	clock
private final AtomicLong	committedDmlCount
private final AtomicReference<Scn>	committedScn
private final AtomicLong	committedTransactions
private final AtomicReference<String[]>	currentLogFileName
private final AtomicReference<Scn>	currentScn
private final AtomicInteger	errorCount
private final AtomicReference<Duration>	keepTransactionsDuration
private final AtomicReference<Duration>	lagFromTheSourceDuration
private final AtomicReference<Duration>	lastBatchProcessingDuration
private final AtomicInteger	lastCapturedDmlCount
private final AtomicReference<Duration>	lastCommitDuration
private final AtomicReference<Duration>	lastDurationOfFetchingQuery
private final AtomicReference<Duration>	lastStartLogMiningSessionDuration
private static final org.slf4j.Logger	LOGGER
private final AtomicInteger	logMinerQueryCount
private final AtomicLong	maxBatchProcessingThroughput
private final AtomicReference<Duration>	maxBatchProcessingTime
private final AtomicLong	maxCapturedDmlCount
private final AtomicReference<Duration>	maxCommitDuration
private final AtomicReference<Duration>	maxDurationOfFetchingQuery
private final AtomicLong	maximumLogsMined
private final AtomicReference<Duration>	maxLagFromTheSourceDuration
private final AtomicReference<Duration>	maxStartingLogMiningSessionDuration
private static final long	MILLIS_PER_SECOND
private final AtomicLong	millisecondToSleepBetweenMiningQuery
private final AtomicReference<Duration>	minBatchProcessingTime
private final AtomicLong	minimumLogsMined
private final AtomicLong	miningSessionProcessGlobalAreaMaxMemory
private final AtomicLong	miningSessionProcessGlobalAreaMemory
private final AtomicLong	miningSessionUserGlobalAreaMaxMemory
private final AtomicLong	miningSessionUserGlobalAreaMemory
private final AtomicReference<Duration>	minLagFromTheSourceDuration
private final AtomicLong	networkConnectionProblemsCounter
private final AtomicReference<Scn>	offsetScn
private final AtomicReference<Scn>	oldestScn
private final AtomicLong	oversizedTransactions
private final AtomicReference<String[]>	redoLogStatus
private final AtomicLong	registeredDmlCount
private final AtomicReference<LRUCacheMap<String,String>>	rolledBackTransactionIds
private final AtomicLong	rolledBackTransactions
private final AtomicInteger	scnFreezeCount
private final long	sleepTimeDefault
private final long	sleepTimeIncrement
private final long	sleepTimeMax
private final long	sleepTimeMin
private final Instant	startTime
private final AtomicInteger	switchCounter
private final AtomicLong	timeDifference
private final AtomicReference<Duration>	totalBatchProcessingDuration
private final AtomicInteger	totalCapturedDmlCount
private final AtomicReference<Duration>	totalDurationOfFetchingQuery
private final AtomicReference<Duration>	totalParseTime
private final AtomicLong	totalProcessedRows
private final AtomicReference<Duration>	totalProcessingTime
private final AtomicReference<Duration>	totalResultSetNextTime
private final AtomicReference<Duration>	totalStartLogMiningSessionDuration
private static final int	TRANSACTION_ID_SET_SIZE
private final AtomicInteger	unparsableDdlCount
private final AtomicInteger	warningCount
private final AtomicReference<ZoneOffset>	zoneOffset

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

metadataProvider, taskContext

Constructor Summary

Constructors

Constructor	Description
OracleStreamingChangeEventSourceMetrics(CdcSourceTaskContext taskContext, ChangeEventQueueMetrics changeEventQueueMetrics, EventMetadataProvider metadataProvider, OracleConnectorConfig connectorConfig)
OracleStreamingChangeEventSourceMetrics(CdcSourceTaskContext taskContext, ChangeEventQueueMetrics changeEventQueueMetrics, EventMetadataProvider metadataProvider, OracleConnectorConfig connectorConfig, Clock clock)	Constructor that allows providing a clock to be used for Tests.

Method Summary

Modifier and Type	Method	Description
void	addAbandonedTransactionId(String transactionId)
void	addCurrentMiningSessionStart(Duration currentStartLogMiningSession)
void	addCurrentParseTime(Duration currentParseTime)
void	addCurrentResultSetNext(Duration currentNextTime)
void	addProcessedRows(Long rows)
void	addRolledBackTransactionId(String transactionId)
void	calculateLagMetrics(Instant changeTime)
void	calculateTimeDifference(OffsetDateTime databaseSystemTime)	Calculates the time difference between the database server and the connector.
void	changeBatchSize(boolean increment, boolean lobEnabled)
void	changeSleepingTime(boolean increment)	change sleeping time
Set<String>	getAbandonedTransactionIds()
long	getAverageBatchProcessingThroughput()	This represents the average number of entries processed per second from LogMiner sessions.
int	getBatchSize()	Maximum number of entries in LogMiner view to fetch.
String	getCommittedScn()
long	getCommitThroughput()
String[]	getCurrentRedoLogFileName()
String	getCurrentScn()
ZoneOffset	getDatabaseOffset()
int	getErrorCount()
long	getFetchingQueryCount()	LogMiner view query returns number of captured DML , Commit and Rollback.
int	getHoursToKeepTransactionInBuffer()
long	getLagFromSourceInMilliseconds()	Lag can temporarily be inaccurate on DST changes.
long	getLastBatchProcessingThroughput()	This represents the number of entries processed per second in the last LogMiner session.
long	getLastBatchProcessingTimeInMilliseconds()
int	getLastCapturedDmlCount()
long	getLastCommitDurationInMilliseconds()
Long	getLastDurationOfFetchQueryInMilliseconds()	LogMiner view query returns number of captured DML , Commit and Rollback.
long	getLastMiningSessionStartTimeInMilliseconds()
long	getMaxBatchProcessingThroughput()	This represents the maximum number of entries processed per second from LogMiner sessions.
long	getMaxBatchProcessingTimeInMilliseconds()
Long	getMaxCapturedDmlInBatch()
long	getMaxCommitDurationInMilliseconds()
Long	getMaxDurationOfFetchQueryInMilliseconds()
long	getMaximumMinedLogCount()
long	getMaxLagFromSourceInMilliseconds()
long	getMaxMiningSessionStartTimeInMilliseconds()
long	getMillisecondsToKeepTransactionsInBuffer()
long	getMillisecondToSleepBetweenMiningQuery()
long	getMinBatchProcessingTimeInMilliseconds()
long	getMinimumMinedLogCount()
long	getMiningSessionProcessGlobalAreaMaxMemoryInBytes()
long	getMiningSessionProcessGlobalAreaMemoryInBytes()
long	getMiningSessionUserGlobalAreaMaxMemoryInBytes()
long	getMiningSessionUserGlobalAreaMemoryInBytes()
long	getMinLagFromSourceInMilliseconds()
long	getNetworkConnectionProblemsCounter()
long	getNumberOfActiveTransactions()
long	getNumberOfCommittedTransactions()
long	getNumberOfOversizedTransactions()
long	getNumberOfRolledBackTransactions()
String	getOffsetScn()
String	getOldestScn()
String[]	getRedoLogStatus()	Exposes states of redo logs: current, active, inactive, unused ...
long	getRegisteredDmlCount()
Set<String>	getRolledBackTransactionIds()
int	getScnFreezeCount()
int	getSwitchCounter()	fetches counter of redo switches for the last day.
long	getTotalCapturedDmlCount()
long	getTotalMiningSessionStartTimeInMilliseconds()
long	getTotalParseTimeInMilliseconds()
long	getTotalProcessedRows()
long	getTotalProcessingTimeInMilliseconds()
long	getTotalResultSetNextTimeInMilliseconds()
int	getUnparsableDdlCount()
int	getWarningCount()
void	incrementCommittedDmlCount(long counter)
void	incrementCommittedTransactions()
void	incrementErrorCount()
void	incrementNetworkConnectionProblemsCounter()
void	incrementOversizedTransactions()
void	incrementRegisteredDmlCount()
void	incrementRolledBackTransactions()
void	incrementScnFreezeCount()
void	incrementUnparsableDdlCount()
void	incrementWarningCount()
void	reset()	Resets metrics.
void	setActiveTransactions(long activeTransactionCount)
void	setBatchSize(int size)	this gives ability to manipulate number of entries in LogMiner view to fetch.
void	setCommittedScn(Scn scn)
void	setCurrentBatchProcessingTime(Duration currentBatchProcessingTime)
void	setCurrentLogFileName(Set<String> names)
void	setCurrentScn(Scn scn)
void	setLastCapturedDmlCount(int dmlCount)
void	setLastCommitDuration(Duration lastDuration)
void	setLastDurationOfBatchCapturing(Duration lastDuration)
void	setLastDurationOfBatchProcessing(Duration lastDuration)
void	setMillisecondToSleepBetweenMiningQuery(long milliseconds)	sets number of milliseconds for connector to sleep before fetching another batch from the LogMiner view
void	setOffsetScn(Scn scn)
void	setOldestScn(Scn scn)
void	setProcessGlobalAreaMemory(long pgaMemory, long pgaMaxMemory)
void	setRedoLogStatus(Map<String,String> status)
void	setSwitchCount(int counter)
void	setUserGlobalAreaMemory(long ugaMemory, long ugaMaxMemory)
String	toString()

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.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, 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

currentScn

private final AtomicReference<Scn> currentScn

logMinerQueryCount

private final AtomicInteger logMinerQueryCount

totalCapturedDmlCount

private final AtomicInteger totalCapturedDmlCount

totalDurationOfFetchingQuery

private final AtomicReference<Duration> totalDurationOfFetchingQuery

lastCapturedDmlCount

private final AtomicInteger lastCapturedDmlCount

lastDurationOfFetchingQuery

private final AtomicReference<Duration> lastDurationOfFetchingQuery

maxCapturedDmlCount

private final AtomicLong maxCapturedDmlCount

totalProcessedRows

private final AtomicLong totalProcessedRows

maxDurationOfFetchingQuery

private final AtomicReference<Duration> maxDurationOfFetchingQuery

totalBatchProcessingDuration

private final AtomicReference<Duration> totalBatchProcessingDuration

lastBatchProcessingDuration

private final AtomicReference<Duration> lastBatchProcessingDuration

totalParseTime

private final AtomicReference<Duration> totalParseTime

totalStartLogMiningSessionDuration

private final AtomicReference<Duration> totalStartLogMiningSessionDuration

lastStartLogMiningSessionDuration

private final AtomicReference<Duration> lastStartLogMiningSessionDuration

maxStartingLogMiningSessionDuration

private final AtomicReference<Duration> maxStartingLogMiningSessionDuration

totalProcessingTime

private final AtomicReference<Duration> totalProcessingTime

minBatchProcessingTime

private final AtomicReference<Duration> minBatchProcessingTime

maxBatchProcessingTime

private final AtomicReference<Duration> maxBatchProcessingTime

totalResultSetNextTime

private final AtomicReference<Duration> totalResultSetNextTime

maxBatchProcessingThroughput

private final AtomicLong maxBatchProcessingThroughput

currentLogFileName

private final AtomicReference<String[]> currentLogFileName

redoLogStatus

private final AtomicReference<String[]> redoLogStatus

minimumLogsMined

private final AtomicLong minimumLogsMined

maximumLogsMined

private final AtomicLong maximumLogsMined

switchCounter

private final AtomicInteger switchCounter

batchSize

private final AtomicInteger batchSize

millisecondToSleepBetweenMiningQuery

private final AtomicLong millisecondToSleepBetweenMiningQuery

networkConnectionProblemsCounter

private final AtomicLong networkConnectionProblemsCounter

keepTransactionsDuration

private final AtomicReference<Duration> keepTransactionsDuration

lagFromTheSourceDuration

private final AtomicReference<Duration> lagFromTheSourceDuration

minLagFromTheSourceDuration

private final AtomicReference<Duration> minLagFromTheSourceDuration

maxLagFromTheSourceDuration

private final AtomicReference<Duration> maxLagFromTheSourceDuration

lastCommitDuration

private final AtomicReference<Duration> lastCommitDuration

maxCommitDuration

private final AtomicReference<Duration> maxCommitDuration

activeTransactions

private final AtomicLong activeTransactions

rolledBackTransactions

private final AtomicLong rolledBackTransactions

committedTransactions

private final AtomicLong committedTransactions

oversizedTransactions

private final AtomicLong oversizedTransactions

abandonedTransactionIds

private final AtomicReference<LRUCacheMap<String,String>> abandonedTransactionIds

rolledBackTransactionIds

private final AtomicReference<LRUCacheMap<String,String>> rolledBackTransactionIds

registeredDmlCount

private final AtomicLong registeredDmlCount

committedDmlCount

private final AtomicLong committedDmlCount

errorCount

private final AtomicInteger errorCount

warningCount

private final AtomicInteger warningCount

scnFreezeCount

private final AtomicInteger scnFreezeCount

timeDifference

private final AtomicLong timeDifference

zoneOffset

private final AtomicReference<ZoneOffset> zoneOffset

oldestScn

private final AtomicReference<Scn> oldestScn

committedScn

private final AtomicReference<Scn> committedScn

offsetScn

private final AtomicReference<Scn> offsetScn

unparsableDdlCount

private final AtomicInteger unparsableDdlCount

miningSessionUserGlobalAreaMemory

private final AtomicLong miningSessionUserGlobalAreaMemory

miningSessionUserGlobalAreaMaxMemory

private final AtomicLong miningSessionUserGlobalAreaMaxMemory

miningSessionProcessGlobalAreaMemory

private final AtomicLong miningSessionProcessGlobalAreaMemory

miningSessionProcessGlobalAreaMaxMemory

private final AtomicLong miningSessionProcessGlobalAreaMaxMemory

batchSizeMin

private final int batchSizeMin

batchSizeMax

private final int batchSizeMax

batchSizeDefault

private final int batchSizeDefault

sleepTimeMin

private final long sleepTimeMin

sleepTimeMax

private final long sleepTimeMax

sleepTimeDefault

private final long sleepTimeDefault

sleepTimeIncrement

private final long sleepTimeIncrement

startTime

private final Instant startTime

clock

private final Clock clock

Constructor Details

OracleStreamingChangeEventSourceMetrics

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

OracleStreamingChangeEventSourceMetrics

@VisibleForTesting
OracleStreamingChangeEventSourceMetrics(CdcSourceTaskContext taskContext,
 ChangeEventQueueMetrics changeEventQueueMetrics,
 EventMetadataProvider metadataProvider,
 OracleConnectorConfig connectorConfig,
 Clock clock)

Constructor that allows providing a clock to be used for Tests.

Method Details

reset

public void reset()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

Resets metrics.

Specified by:

reset in interface ChangeEventSourceMetricsMXBean

Specified by:

reset in interface OracleStreamingChangeEventSourceMetricsMXBean

Overrides:

reset in class DefaultStreamingChangeEventSourceMetrics<OraclePartition>

setCurrentScn

public void setCurrentScn(Scn scn)

setCurrentLogFileName

public void setCurrentLogFileName(Set<String> names)

getMinimumMinedLogCount

public long getMinimumMinedLogCount()

Specified by:

getMinimumMinedLogCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the minimum number of logs used by a mining session

getMaximumMinedLogCount

public long getMaximumMinedLogCount()

Specified by:

getMaximumMinedLogCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the maximum number of logs used by a mining session

setRedoLogStatus

public void setRedoLogStatus(Map<String,String> status)

setSwitchCount

public void setSwitchCount(int counter)

setLastCapturedDmlCount

public void setLastCapturedDmlCount(int dmlCount)

setLastDurationOfBatchCapturing

public void setLastDurationOfBatchCapturing(Duration lastDuration)

setLastDurationOfBatchProcessing

public void setLastDurationOfBatchProcessing(Duration lastDuration)

incrementNetworkConnectionProblemsCounter

public void incrementNetworkConnectionProblemsCounter()

getCurrentScn

public String getCurrentScn()

Specified by:

getCurrentScn in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the current system change number of the database

getTotalCapturedDmlCount

public long getTotalCapturedDmlCount()

Specified by:

getTotalCapturedDmlCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

number of captured DML since the connector is up

getCurrentRedoLogFileName

public String[] getCurrentRedoLogFileName()

Specified by:

getCurrentRedoLogFileName in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

array of current filenames to be used by the mining session.

getRedoLogStatus

public String[] getRedoLogStatus()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

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

Specified by:

getRedoLogStatus in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

array of: (redo log name | status) elements

getSwitchCounter

public int getSwitchCounter()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

fetches counter of redo switches for the last day. If this number is high , like once in 3 minutes, the troubleshooting on the database level is required.

Specified by:

getSwitchCounter in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

counter

getLastDurationOfFetchQueryInMilliseconds

public Long getLastDurationOfFetchQueryInMilliseconds()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

LogMiner view query returns number of captured DML , Commit and Rollback. This is what we call a batch.

Specified by:

getLastDurationOfFetchQueryInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

duration of the last batch fetching

getLastBatchProcessingTimeInMilliseconds

public long getLastBatchProcessingTimeInMilliseconds()

Specified by:

getLastBatchProcessingTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

time of processing the last captured batch

getMaxDurationOfFetchQueryInMilliseconds

public Long getMaxDurationOfFetchQueryInMilliseconds()

Specified by:

getMaxDurationOfFetchQueryInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

average duration of LogMiner view query

getMaxCapturedDmlInBatch

public Long getMaxCapturedDmlInBatch()

Specified by:

getMaxCapturedDmlInBatch in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

max number of DML captured during connector start time

getLastCapturedDmlCount

public int getLastCapturedDmlCount()

Specified by:

getLastCapturedDmlCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

number of captured DL during last mining session

getTotalProcessedRows

public long getTotalProcessedRows()

Specified by:

getTotalProcessedRows in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the total number of log miner rows processed.

getTotalResultSetNextTimeInMilliseconds

public long getTotalResultSetNextTimeInMilliseconds()

Specified by:

getTotalResultSetNextTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the total number of milliseconds spent iterating log miner results calling next.

getAverageBatchProcessingThroughput

public long getAverageBatchProcessingThroughput()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

This represents the average number of entries processed per second from LogMiner sessions. Entries include things such as DMLs, commits, rollbacks, etc.

Specified by:

getAverageBatchProcessingThroughput in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the average number of entries per second from LogMiner sessions

getLastBatchProcessingThroughput

public long getLastBatchProcessingThroughput()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

This represents the number of entries processed per second in the last LogMiner session. Entries include things such as DMLs, commits, rollbacks, etc.

Specified by:

getLastBatchProcessingThroughput in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of entries processed per second from last LogMiner session

getFetchingQueryCount

public long getFetchingQueryCount()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

LogMiner view query returns number of captured DML , Commit and Rollback. This is what we call a batch.

Specified by:

getFetchingQueryCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

number of all processed batches

getBatchSize

public int getBatchSize()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

Maximum number of entries in LogMiner view to fetch. This is used to set the diapason of the SCN in mining query. If difference between "start SCN" and "end SCN" to mine exceeds this limit, end SCN will be set to "start SCN" + batchSize

Specified by:

getBatchSize in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the limit

getMillisecondToSleepBetweenMiningQuery

public long getMillisecondToSleepBetweenMiningQuery()

Specified by:

getMillisecondToSleepBetweenMiningQuery in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

number of milliseconds for connector to sleep before fetching another batch from the LogMiner view

getHoursToKeepTransactionInBuffer

public int getHoursToKeepTransactionInBuffer()

Specified by:

getHoursToKeepTransactionInBuffer in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of hours to keep transaction in buffer before abandoning

getMillisecondsToKeepTransactionsInBuffer

public long getMillisecondsToKeepTransactionsInBuffer()

Specified by:

getMillisecondsToKeepTransactionsInBuffer in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of milliseconds to keep transactions in the buffer before abandoning

getMaxBatchProcessingThroughput

public long getMaxBatchProcessingThroughput()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

This represents the maximum number of entries processed per second from LogMiner sessions. Entries include things such as DMLs, commits, rollbacks, etc.

Specified by:

getMaxBatchProcessingThroughput in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the maximum number of entries processed per second from LogMiner sessions

getNetworkConnectionProblemsCounter

public long getNetworkConnectionProblemsCounter()

Specified by:

getNetworkConnectionProblemsCounter in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of connection problems detected

getTotalParseTimeInMilliseconds

public long getTotalParseTimeInMilliseconds()

Specified by:

getTotalParseTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the total number of milliseconds used to parse DDL/DML statements

addCurrentParseTime

public void addCurrentParseTime(Duration currentParseTime)

getTotalMiningSessionStartTimeInMilliseconds

public long getTotalMiningSessionStartTimeInMilliseconds()

Specified by:

getTotalMiningSessionStartTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the total number of milliseconds spent starting a log mining session

addCurrentMiningSessionStart

public void addCurrentMiningSessionStart(Duration currentStartLogMiningSession)

getLastMiningSessionStartTimeInMilliseconds

public long getLastMiningSessionStartTimeInMilliseconds()

Specified by:

getLastMiningSessionStartTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the total number of milliseconds the last mining session took to start

getMaxMiningSessionStartTimeInMilliseconds

public long getMaxMiningSessionStartTimeInMilliseconds()

Specified by:

getMaxMiningSessionStartTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the duration in milliseconds of the longest mining session start

getTotalProcessingTimeInMilliseconds

public long getTotalProcessingTimeInMilliseconds()

Specified by:

getTotalProcessingTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the total number of milliseconds spent mining and processing results

getMinBatchProcessingTimeInMilliseconds

public long getMinBatchProcessingTimeInMilliseconds()

Specified by:

getMinBatchProcessingTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the minimum time in milliseconds spent processing results from a single LogMiner session

getMaxBatchProcessingTimeInMilliseconds

public long getMaxBatchProcessingTimeInMilliseconds()

Specified by:

getMaxBatchProcessingTimeInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the maximum time in milliseconds spent processing results from a single LogMiner session

setCurrentBatchProcessingTime

public void setCurrentBatchProcessingTime(Duration currentBatchProcessingTime)

addCurrentResultSetNext

public void addCurrentResultSetNext(Duration currentNextTime)

addProcessedRows

public void addProcessedRows(Long rows)

setBatchSize

public void setBatchSize(int size)

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

this gives ability to manipulate number of entries in LogMiner view to fetch. It has limits to prevent abnormal values

Specified by:

setBatchSize in interface OracleStreamingChangeEventSourceMetricsMXBean

Parameters:

size - limit

setMillisecondToSleepBetweenMiningQuery

public void setMillisecondToSleepBetweenMiningQuery(long milliseconds)

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

sets number of milliseconds for connector to sleep before fetching another batch from the LogMiner view

Specified by:

setMillisecondToSleepBetweenMiningQuery in interface OracleStreamingChangeEventSourceMetricsMXBean

Parameters:

milliseconds - to sleep

changeSleepingTime

public void changeSleepingTime(boolean increment)

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

change sleeping time

Specified by:

changeSleepingTime in interface OracleStreamingChangeEventSourceMetricsMXBean

Parameters:

increment - true to add, false to deduct

changeBatchSize

public void changeBatchSize(boolean increment,
 boolean lobEnabled)

Specified by:

changeBatchSize in interface OracleStreamingChangeEventSourceMetricsMXBean

getNumberOfActiveTransactions

public long getNumberOfActiveTransactions()

Specified by:

getNumberOfActiveTransactions in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

number of current active transactions in the transaction buffer

getNumberOfRolledBackTransactions

public long getNumberOfRolledBackTransactions()

Specified by:

getNumberOfRolledBackTransactions in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of rolled back transactions in the transaction buffer

getNumberOfCommittedTransactions

public long getNumberOfCommittedTransactions()

Specified by:

getNumberOfCommittedTransactions in interface OracleStreamingChangeEventSourceMetricsMXBean

Specified by:

getNumberOfCommittedTransactions in interface StreamingMetricsMXBean

Overrides:

getNumberOfCommittedTransactions in class DefaultStreamingChangeEventSourceMetrics<OraclePartition>

Returns:

the number of committed transactions in the transaction buffer

getNumberOfOversizedTransactions

public long getNumberOfOversizedTransactions()

Specified by:

getNumberOfOversizedTransactions in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of abandoned transactions because of number of events oversized

getCommitThroughput

public long getCommitThroughput()

Specified by:

getCommitThroughput in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

average number of committed transactions per second in the transaction buffer

getRegisteredDmlCount

public long getRegisteredDmlCount()

Specified by:

getRegisteredDmlCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of registered DML operations in the transaction buffer

getOldestScn

public String getOldestScn()

Specified by:

getOldestScn in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the oldest SCN in the transaction buffer

getCommittedScn

public String getCommittedScn()

Specified by:

getCommittedScn in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the last committed SCN from the transaction buffer

getOffsetScn

public String getOffsetScn()

Specified by:

getOffsetScn in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the current offset SCN

getLagFromSourceInMilliseconds

public long getLagFromSourceInMilliseconds()

Description copied from interface: OracleStreamingChangeEventSourceMetricsMXBean

Lag can temporarily be inaccurate on DST changes. This is because the timestamps received from LogMiner are in the database local time and do not contain time zone information.

Specified by:

getLagFromSourceInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

lag in milliseconds of latest captured change timestamp from transaction logs and it's placement in the transaction buffer.

getMaxLagFromSourceInMilliseconds

public long getMaxLagFromSourceInMilliseconds()

Specified by:

getMaxLagFromSourceInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

maximum lag in milliseconds with the data source

getMinLagFromSourceInMilliseconds

public long getMinLagFromSourceInMilliseconds()

Specified by:

getMinLagFromSourceInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

minimum lag in milliseconds with the data source

getAbandonedTransactionIds

public Set<String> getAbandonedTransactionIds()

Specified by:

getAbandonedTransactionIds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

list of abandoned transaction ids from the transaction buffer

getRolledBackTransactionIds

public Set<String> getRolledBackTransactionIds()

Specified by:

getRolledBackTransactionIds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

slist of rolled back transaction ids from the transaction buffer

getLastCommitDurationInMilliseconds

public long getLastCommitDurationInMilliseconds()

Specified by:

getLastCommitDurationInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

total duration in milliseconds the last commit operation took in the transaction buffer

getMaxCommitDurationInMilliseconds

public long getMaxCommitDurationInMilliseconds()

Specified by:

getMaxCommitDurationInMilliseconds in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the duration in milliseconds that the longest commit operation took in the transaction buffer

getErrorCount

public int getErrorCount()

Specified by:

getErrorCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of errors detected in the connector's log

getWarningCount

public int getWarningCount()

Specified by:

getWarningCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of warnings detected in the connector's log

getScnFreezeCount

public int getScnFreezeCount()

Specified by:

getScnFreezeCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of number of times the SCN does not change and is considered frozen

getUnparsableDdlCount

public int getUnparsableDdlCount()

Specified by:

getUnparsableDdlCount in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

the number of unparsable ddl statements

getMiningSessionUserGlobalAreaMemoryInBytes

public long getMiningSessionUserGlobalAreaMemoryInBytes()

Specified by:

getMiningSessionUserGlobalAreaMemoryInBytes in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

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

getMiningSessionUserGlobalAreaMaxMemoryInBytes

public long getMiningSessionUserGlobalAreaMaxMemoryInBytes()

Specified by:

getMiningSessionUserGlobalAreaMaxMemoryInBytes in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

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

getMiningSessionProcessGlobalAreaMemoryInBytes

public long getMiningSessionProcessGlobalAreaMemoryInBytes()

Specified by:

getMiningSessionProcessGlobalAreaMemoryInBytes in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

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

getMiningSessionProcessGlobalAreaMaxMemoryInBytes

public long getMiningSessionProcessGlobalAreaMaxMemoryInBytes()

Specified by:

getMiningSessionProcessGlobalAreaMaxMemoryInBytes in interface OracleStreamingChangeEventSourceMetricsMXBean

Returns:

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

setOldestScn

public void setOldestScn(Scn scn)

setCommittedScn

public void setCommittedScn(Scn scn)

setOffsetScn

public void setOffsetScn(Scn scn)

setActiveTransactions

public void setActiveTransactions(long activeTransactionCount)

incrementRolledBackTransactions

public void incrementRolledBackTransactions()

incrementCommittedTransactions

public void incrementCommittedTransactions()

incrementOversizedTransactions

public void incrementOversizedTransactions()

incrementRegisteredDmlCount

public void incrementRegisteredDmlCount()

incrementCommittedDmlCount

public void incrementCommittedDmlCount(long counter)

incrementErrorCount

public void incrementErrorCount()

incrementWarningCount

public void incrementWarningCount()

incrementScnFreezeCount

public void incrementScnFreezeCount()

addAbandonedTransactionId

public void addAbandonedTransactionId(String transactionId)

addRolledBackTransactionId

public void addRolledBackTransactionId(String transactionId)

setLastCommitDuration

public void setLastCommitDuration(Duration lastDuration)

calculateTimeDifference

public void calculateTimeDifference(OffsetDateTime databaseSystemTime)

Calculates the time difference between the database server and the connector. Along with the time difference also the offset of the database server time to UTC is stored. Both values are required to calculate lag metrics.

Parameters:

databaseSystemTime - the system time (SYSTIMESTAMP) of the database

getDatabaseOffset

public ZoneOffset getDatabaseOffset()

calculateLagMetrics

public void calculateLagMetrics(Instant changeTime)

incrementUnparsableDdlCount

public void incrementUnparsableDdlCount()

setUserGlobalAreaMemory

public void setUserGlobalAreaMemory(long ugaMemory,
 long ugaMaxMemory)

setProcessGlobalAreaMemory

public void setProcessGlobalAreaMemory(long pgaMemory,
 long pgaMaxMemory)

toString

public String toString()

Overrides:

toString in class Object