Interface OracleStreamingChangeEventSourceMetricsMXBean

All Superinterfaces:
ChangeEventSourceMetricsMXBean, CommonEventMetricsMXBean, ConnectionMetricsMXBean, QueueMetricsMXBean, SchemaMetricsMXBean, StreamingChangeEventSourceMetricsMXBean, StreamingMetricsMXBean
All Known Implementing Classes:
OracleStreamingChangeEventSourceMetrics

public interface OracleStreamingChangeEventSourceMetricsMXBean extends StreamingChangeEventSourceMetricsMXBean
The JMX exposed interface for Oracle streaming metrics.
  • Method Details

    • getCurrentScn

      String getCurrentScn()
      Returns:
      the current system change number of the database
    • getCurrentRedoLogFileName

      String[] getCurrentRedoLogFileName()
      Returns:
      array of current filenames to be used by the mining session.
    • 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
    • getRedoLogStatus

      String[] getRedoLogStatus()
      Exposes states of redo logs: current, active, inactive, unused ...
      Returns:
      array of: (redo log name | status) elements
    • getSwitchCounter

      int getSwitchCounter()
      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.
      Returns:
      counter
    • getTotalCapturedDmlCount

      long getTotalCapturedDmlCount()
      Returns:
      number of captured DML since the connector is up
    • getMaxDurationOfFetchQueryInMilliseconds

      Long getMaxDurationOfFetchQueryInMilliseconds()
      Returns:
      average duration of LogMiner view query
    • getLastDurationOfFetchQueryInMilliseconds

      Long getLastDurationOfFetchQueryInMilliseconds()
      LogMiner view query returns number of captured DML , Commit and Rollback. This is what we call a batch.
      Returns:
      duration of the last batch fetching
    • getFetchingQueryCount

      long getFetchingQueryCount()
      LogMiner view query returns number of captured DML , Commit and Rollback. This is what we call a batch.
      Returns:
      number of all processed batches
    • getMaxCapturedDmlInBatch

      Long getMaxCapturedDmlInBatch()
      Returns:
      max number of DML captured during connector start time
    • getLastBatchProcessingTimeInMilliseconds

      long getLastBatchProcessingTimeInMilliseconds()
      Returns:
      time of processing the last captured batch
    • getLastCapturedDmlCount

      int getLastCapturedDmlCount()
      Returns:
      number of captured DL during last mining session
    • getBatchSize

      int getBatchSize()
      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
      Returns:
      the limit
    • setBatchSize

      void setBatchSize(int size)
      this gives ability to manipulate number of entries in LogMiner view to fetch. It has limits to prevent abnormal values
      Parameters:
      size - limit
    • getMillisecondToSleepBetweenMiningQuery

      long getMillisecondToSleepBetweenMiningQuery()
      Returns:
      number of milliseconds for connector to sleep before fetching another batch from the LogMiner view
    • setMillisecondToSleepBetweenMiningQuery

      void setMillisecondToSleepBetweenMiningQuery(long milliseconds)
      sets number of milliseconds for connector to sleep before fetching another batch from the LogMiner view
      Parameters:
      milliseconds - to sleep
    • changeSleepingTime

      void changeSleepingTime(boolean increment)
      change sleeping time
      Parameters:
      increment - true to add, false to deduct
    • changeBatchSize

      void changeBatchSize(boolean increment, boolean lobEnabled)
    • getMaxBatchProcessingThroughput

      long getMaxBatchProcessingThroughput()
      This represents the maximum number of entries processed per second from LogMiner sessions. Entries include things such as DMLs, commits, rollbacks, etc.
      Returns:
      the maximum number of entries processed per second from LogMiner sessions
    • getAverageBatchProcessingThroughput

      long getAverageBatchProcessingThroughput()
      This represents the average number of entries processed per second from LogMiner sessions. Entries include things such as DMLs, commits, rollbacks, etc.
      Returns:
      the average number of entries per second from LogMiner sessions
    • getLastBatchProcessingThroughput

      long getLastBatchProcessingThroughput()
      This represents the number of entries processed per second in the last LogMiner session. Entries include things such as DMLs, commits, rollbacks, etc.
      Returns:
      the number of entries processed per second from last LogMiner session
    • getNetworkConnectionProblemsCounter

      long getNetworkConnectionProblemsCounter()
      Returns:
      the number of connection problems detected
    • getTotalParseTimeInMilliseconds

      long getTotalParseTimeInMilliseconds()
      Returns:
      the total number of milliseconds used to parse DDL/DML statements
    • getTotalMiningSessionStartTimeInMilliseconds

      long getTotalMiningSessionStartTimeInMilliseconds()
      Returns:
      the total number of milliseconds spent starting a log mining session
    • getLastMiningSessionStartTimeInMilliseconds

      long getLastMiningSessionStartTimeInMilliseconds()
      Returns:
      the total number of milliseconds the last mining session took to start
    • getMaxMiningSessionStartTimeInMilliseconds

      long getMaxMiningSessionStartTimeInMilliseconds()
      Returns:
      the duration in milliseconds of the longest mining session start
    • getTotalProcessingTimeInMilliseconds

      long getTotalProcessingTimeInMilliseconds()
      Returns:
      the total number of milliseconds spent mining and processing results
    • getMinBatchProcessingTimeInMilliseconds

      long getMinBatchProcessingTimeInMilliseconds()
      Returns:
      the minimum time in milliseconds spent processing results from a single LogMiner session
    • getMaxBatchProcessingTimeInMilliseconds

      long getMaxBatchProcessingTimeInMilliseconds()
      Returns:
      the maximum time in milliseconds spent processing results from a single LogMiner session
    • getTotalProcessedRows

      long getTotalProcessedRows()
      Returns:
      the total number of log miner rows processed.
    • getTotalResultSetNextTimeInMilliseconds

      long getTotalResultSetNextTimeInMilliseconds()
      Returns:
      the total number of milliseconds spent iterating log miner results calling next.
    • getHoursToKeepTransactionInBuffer

      int getHoursToKeepTransactionInBuffer()
      Returns:
      the number of hours to keep transaction in buffer before abandoning
    • getNumberOfActiveTransactions

      long getNumberOfActiveTransactions()
      Returns:
      number of current active transactions in the transaction buffer
    • getNumberOfCommittedTransactions

      long getNumberOfCommittedTransactions()
      Specified by:
      getNumberOfCommittedTransactions in interface StreamingMetricsMXBean
      Returns:
      the number of committed transactions in the transaction buffer
    • getNumberOfRolledBackTransactions

      long getNumberOfRolledBackTransactions()
      Returns:
      the number of rolled back transactions in the transaction buffer
    • getNumberOfOversizedTransactions

      long getNumberOfOversizedTransactions()
      Returns:
      the number of abandoned transactions because of number of events oversized
    • getCommitThroughput

      long getCommitThroughput()
      Returns:
      average number of committed transactions per second in the transaction buffer
    • getRegisteredDmlCount

      long getRegisteredDmlCount()
      Returns:
      the number of registered DML operations in the transaction buffer
    • getOldestScn

      String getOldestScn()
      Returns:
      the oldest SCN in the transaction buffer
    • getCommittedScn

      String getCommittedScn()
      Returns:
      the last committed SCN from the transaction buffer
    • getOffsetScn

      String getOffsetScn()
      Returns:
      the current offset SCN
    • getLagFromSourceInMilliseconds

      long getLagFromSourceInMilliseconds()
      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.
      Returns:
      lag in milliseconds of latest captured change timestamp from transaction logs and it's placement in the transaction buffer.
    • getMaxLagFromSourceInMilliseconds

      long getMaxLagFromSourceInMilliseconds()
      Returns:
      maximum lag in milliseconds with the data source
    • getMinLagFromSourceInMilliseconds

      long getMinLagFromSourceInMilliseconds()
      Returns:
      minimum lag in milliseconds with the data source
    • getAbandonedTransactionIds

      Set<String> getAbandonedTransactionIds()
      Returns:
      list of abandoned transaction ids from the transaction buffer
    • getRolledBackTransactionIds

      Set<String> getRolledBackTransactionIds()
      Returns:
      slist of rolled back transaction ids from the transaction buffer
    • getLastCommitDurationInMilliseconds

      long getLastCommitDurationInMilliseconds()
      Returns:
      total duration in milliseconds the last commit operation took in the transaction buffer
    • getMaxCommitDurationInMilliseconds

      long getMaxCommitDurationInMilliseconds()
      Returns:
      the duration in milliseconds that the longest commit operation took in the transaction buffer
    • getErrorCount

      int getErrorCount()
      Returns:
      the number of errors detected in the connector's log
    • getWarningCount

      int getWarningCount()
      Returns:
      the number of warnings detected in the connector's log
    • getScnFreezeCount

      int getScnFreezeCount()
      Returns:
      the number of number of times the SCN does not change and is considered frozen
    • getUnparsableDdlCount

      int getUnparsableDdlCount()
      Returns:
      the number of unparsable ddl statements
    • 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.
    • reset

      void reset()
      Resets metrics.
      Specified by:
      reset in interface ChangeEventSourceMetricsMXBean