Skip to main content

Metrics

Generated from TaskMetricsMXBean by MetricsReferenceTest; do not edit by hand.

Each capture task registers one MXBean, sh.oso.cdc:type=task,server=<prefix>, where the prefix is cdc.topic.prefix. The JMX Prometheus exporter configuration in ops/jmx-exporter/oracle-cdc.yml publishes every numeric attribute under the name below with a server label. A Grafana dashboard (ops/grafana/oracle-cdc-connector.json) and Prometheus alert rules (ops/alerts/prometheus-rules.yaml) use these names.

AttributePrometheus nameKindDescription
BufferHeapBytesoracle_cdc_buffer_heap_bytesgaugeEstimated heap bytes held by open transactions.
BufferMemoryMaxBytesoracle_cdc_buffer_memory_max_bytesgaugecdc.buffer.memory.max.bytes, for ratio alerts.
BufferedEventsoracle_cdc_buffered_eventsgaugeChanges held for open transactions, on heap and spilled.
DecodeFailuresoracle_cdc_decode_failures_totalcounterRows that could not be decoded and went to the DLQ (cdc.on.decode.error=dlq).
DlqRecordsoracle_cdc_dlq_records_totalcounterDLQ records queued.
EventsAppliedoracle_cdc_events_applied_totalcounterMining events applied to the transaction buffer.
HeartbeatsSentoracle_cdc_heartbeats_sent_totalcounterHeartbeat records queued.
IdlePollsoracle_cdc_idle_polls_totalcounterPolls that found no new redo.
JournalChunksoracle_cdc_journal_chunks_totalcounterTransaction journal chunks queued.
JournalTombstonesoracle_cdc_journal_tombstones_totalcounterTransaction journal tombstones queued.
JournaledTransactionsoracle_cdc_journaled_transactionsgaugeOpen transactions written to the transaction journal.
LagReplaysoracle_cdc_lag_replays_totalcounterSteps mined again with a dictionary from the redo because rows predate a later DDL (the lag case).
LargestTransactionsnot exported (composite)tableThe 20 largest open transactions by bytes buffered.
LastCommitTimestampMillisoracle_cdc_last_commit_timestamp_millisgaugeCommit time of the last transaction queued, epoch milliseconds, or -1.
LastStepMillisoracle_cdc_last_step_millisgaugeDuration of the last mining step, in milliseconds.
LobInsertsMergedoracle_cdc_lob_inserts_merged_totalcounterLOB locator updates folded into their INSERT.
LobRowsAppliedoracle_cdc_lob_rows_applied_totalcounterLOB_WRITE, LOB_TRIM and LOB_ERASE rows applied.
MillisBehindSourceoracle_cdc_millis_behind_sourcegaugeTime between the commit of the last transaction queued and its queueing, in milliseconds.
MinedToScnoracle_cdc_mined_to_scngaugeSCN the engine has mined up to.
OldestOpenScnoracle_cdc_oldest_open_scngaugeFirst SCN of the oldest open transaction that is not journaled, or -1; the resume position cannot pass it.
OpenTransactionsoracle_cdc_open_transactionsgaugeTransactions open in the buffer.
OpsEventsoracle_cdc_ops_events_totalcounterOps topic events queued.
OrphansReleasedoracle_cdc_orphans_released_totalcounterOpen transactions released by orphan detection.
QueueDepthoracle_cdc_queue_depthgaugeRecords waiting for Kafka Connect to poll.
Reconnectsoracle_cdc_reconnects_totalcounterReconnections after a transient database error (CDC-1001).
RolledBackTransactionsoracle_cdc_rolled_back_transactions_totalcounterTransactions rolled back while buffered.
RowsMinedoracle_cdc_rows_mined_totalcounterRows returned by LogMiner, including rows for other tables in the same logs and transaction control rows.
SafeEndScnoracle_cdc_safe_end_scngaugeDatabase SCN read at the last step: the end of what can be mined.
ScnLagoracle_cdc_scn_laggaugeSafeEndScn minus MinedToScn.
SessionRecyclesoracle_cdc_session_recycles_totalcounterLogMiner sessions restarted at cdc.mining.session.max.age.ms.
SnapshotChunkRetriesoracle_cdc_snapshot_chunk_retries_totalcounterSnapshot chunks read again after an error, with a fresh SCN.
SnapshotChunksPendingoracle_cdc_snapshot_chunks_pendinggaugeSnapshot chunks read and waiting for streaming to pass their SCN.
SnapshotChunksPublishedoracle_cdc_snapshot_chunks_published_totalcounterSnapshot chunks published, after streaming passed their SCN.
SnapshotChunksReadoracle_cdc_snapshot_chunks_read_totalcounterSnapshot chunks read.
SnapshotRowsPublishedoracle_cdc_snapshot_rows_published_totalcounterSnapshot rows published as op=r records.
SnapshotTablesRemainingoracle_cdc_snapshot_tables_remaininggaugeTables the running snapshot has still to read.
SpillMaxBytesoracle_cdc_spill_max_bytesgaugecdc.buffer.spill.max.bytes, for ratio alerts.
SpilledBytesoracle_cdc_spilled_bytesgaugeBytes in spill files.
SpilledTransactionsoracle_cdc_spilled_transactionsgaugeOpen transactions spilled to disk.
StepCutsoracle_cdc_step_cuts_totalcounterSteps cut after a DDL that changed the captured object ids.
StepRetriesoracle_cdc_step_retries_totalcounterSteps discarded and mined again after a retriable LogMiner error (CDC-1002).
StepTimeoutsoracle_cdc_step_timeouts_totalcounterSteps cancelled at cdc.mining.query.timeout.ms; the next step covers fewer logs.
Stepsoracle_cdc_steps_totalcounterMining steps applied.
TransactionsCommittedoracle_cdc_transactions_committed_totalcounterCommitted transactions handed to the sink.
TransactionsDiscardedoracle_cdc_transactions_discarded_totalcounterTransactions dropped by cdc.transaction.max.age.action=discard.
TransactionsSkippedoracle_cdc_transactions_skipped_totalcounterCommitted transactions already delivered before a restart, skipped whole.
UndoneEventsoracle_cdc_undone_events_totalcounterChanges removed or downgraded by savepoint and statement rollbacks.
UnmatchedUndooracle_cdc_unmatched_undo_totalcounterUndo rows that matched no buffered change.
WindowLogsoracle_cdc_window_logsgaugeRedo logs in the last step's window.