Skip to content
TwinCommitDocs

twincommit run

twincommit run streams committed transactions from the source log to the target until it is stopped. It serves /metrics, /status and /control on metrics_addr, and writes JSON log lines to stderr.

Usage

Section titled “Usage”
Terminal window
twincommit run -config pipeline.yaml
Flag Description
-config Path to the pipeline file
-drop-slot PostgreSQL sources only: drop the replication slot and exit

Behaviour

Section titled “Behaviour”
  • Retries: after any error, such as a lost connection or a target restart, run resumes from the checkpoint with exponential backoff.
  • Shutdown: on SIGINT or SIGTERM it finishes the current batch, commits and exits 0.
  • Broken tables: a table that hits an operation the log cannot describe is skipped; the others continue. See broken tables.

Example log

Section titled “Example log”
{"level":"info","msg":"streaming","from":"0000000004F2A100","tables":42}
{"level":"info","msg":"caught up","lag_seconds":0.31}