3.debug.adoc

OpenLogReplicator.json - debug element

Author: Adam Leszczyński <aleszczynski@bersler.com>, version: 1.9.0, date: 2026-01-23

This section describes the debug element in the OpenLogReplicator JSON configuration. All parameters are intended for troubleshooting and testing; use caution when enabling in production.

Table 1. Debug element

Parameter	Type / constraints	Description and notes
stop-log-switches	integer, min: 0, default: 0	Stop the process after the specified number of log switches. Use 0 to disable.
stop-checkpoints	integer, min: 0, default: 0	Stop the process after the specified number of LWN checkpoints. Use 0 to disable.
stop-transactions	integer, min: 0, default: 0	Stop the process after the specified number of processed transactions. Use 0 to disable.
owner	string, max length: 128	Owner/schema name used when constructing the internal debug table identifier. The user does not have to exit during OLR startup and can be dynamically created later.
table	string, max length: 128	Table name used for debug-triggering. When set, any DML affecting this fully-qualified table may cause the process to stop immediately (commit not required). The table does not have to exit during OLR startup and can be dynamically created later.

Caution

These parameters can cause abrupt process termination. Use only in controlled test environments or when collecting targeted diagnostics.

Example debug configuration (JSON)

{
  "debug": {
    "stop-log-switches": 0,
    "stop-checkpoints": 0,
    "stop-transactions": 0,
    "owner": "TEST_SCHEMA",
    "table": "DEBUG_TABLE"
  }
}