Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status


SpinalTap is a general-purpose reliable Change Data Capture (CDC) service, capable of detecting data mutations with low-latency across different data sources, and propagating them as standardized events to downstream consumers. SpinalTap has become an integral component in Airbnb's infrastructure platform and data processing pipeline, on which several critical applications are reliant on. More information from our engineering blog.


SpinalTap does not support message authentication yet as part of its current open-source offering.

Message authentication is a requirement to enforce authenticity and accessibility of messages propagated in the message bus, as well as source verification of transmitted messages. Given SpinalTap is by design a source & destination agnostic library, we believe the burden of supplying a message authentication workflow lies on the message bus solution used, or as an extension to the destination component implement adopted. This is inline with the usage within Airbnb’s infrastructure, where SpinalTap is just another client to our internal message transport which in itself should supply message authentication as a general offering for all its clients. If the need arises in the future, message authentication can be seamlessly integrated within the library as a potential supported feature.

Getting Started

Install Thrift 0.9.3 Compiler

Building SpinalTap Standalone JAR

cd spinaltap-standalone
../gradlew shadowjar

Download and Build Kafka

Recommend the version or above (

cd kafka
./gradle build

MySQL Configuration

MySQL server should be configured to use Row-based binlog:


SpinalTap Standalone Configuration

zk-connection-string: localhost:2181 
zk-namespace: spinaltap-standalone
  bootstrap_servers: localhost:9092
mysql-user: spinaltap
mysql-password: spinaltap
mysql-server-id: 12345
  port: 3306
  database: schema-store
  archive-database: schema-store-archive
  - name: mysql-db-1
    host: localhost
    port: 3306
    host_role: MASTER
    socket_timeout_seconds: -1
    schema_version_enabled: true
      fileName: mysql-bin-changelog.001234
      position: 4
      nextPosition: 4
      - test:users
      - test:places
      pool_size: 2
      buffer_size: 1000
  - name: mysql-db-2
    port: 3306
      - db1:table1
      buffer_size: 1000
  • zk-connection-string: ZK connection string.
  • zk-namespace: ZK namespace, please make sure it exists.
  • kafka-config: Kafka destination config, boostrap_servers is required.
  • mysql-user: username to connect to MySQL server, SELECT, REPLICATION SLAVE, REPLICATION CLIENT, SHOW VIEW permissions are required.
  • mysql-password: password to connect to MySQL server.
  • mysql-server-id: MySQL server id for replication purpose, in the range from 1 to 2^32 – 1. Must be unique across whole replication group. If you have other slaves that connect to the MySQL server, SpinalTap's server id must be different from theirs.

MySQL Schema Store

MySQL schema store is a MySQL instance which is used to store SpinalTap MySQL table schemas and their version history. When this feature is enabled, SpinalTap will track table schema changes and save the schema version snapshots into the schema store.

  • host: schema store hostname.
  • port: schema store port.
  • database: database which stores table schema history.
  • archive-database: database which stores the archived table schema history.

MySQL Source Configuration

  • name: source name, must be unique among other sources.
  • host: MySQL server host.
  • port: MySQL server port.
  • host_role: Could be MASTER, REPLICA, or MIGRATION. The corresponding Kafka topic prefixes are different. The default value is MASTER.
  • socket_timeout_seconds: MySQL Binlog client socket connection timeout in seconds. The default value is 90. A negative value disables SO_TIMEOUT
  • schema_version_enabled: Whether schema versioning is enabled for this source. The default value is false.
  • initial_binlog_position: The binlog position SpinalTap should start streaming when SpinalTap connects to this source for the first time. By default SpinalTap streams from the latest binlog position.
  • tables: table list spinaltap should listen and stream mutations from. The format is <database_name>:<table_name>.
  • destination: Destination pool/buffer config.

Launch ZooKeeper Cluster

cd kafka
bin/ config/

Launch Kafka Broker

cd kafka
bin/ config/

Launch SpinalTap Standalone

java -jar build/libs/spinaltap-standalone-all.jar spinaltap_standalone.yaml


Change Data Capture (CDC) service



Code of conduct

Security policy





No releases published


No packages published