Skip to main content

Use Gravity to Migrate Data to StoneDB

Gravity introduction

Gravity is a data migration tool developed by Mobike written in Golang. Though it is not frequently updated on GitHub, many developers are responding to issues. Gravity supports full synchronization, incremental synchronization, and publish of data updates to message queues. It can be deployed on elastic cloud servers (ECSs), Docker containers, and Kubernetes containers.

It is designed to be a customizable data migration tool that:

  • Supports multiple data sources and destinations.
  • Supports Kubernetes-based replication clusters.


For more information about Gravity on GitHub, visit

Use cases

  • Data Bus: uses change data capture (MySQL binlog, MongoDB Oplog) and batch table scan to publish data to Kafka for downstream consumption.
  • Unidirectional data synchronization: fully or incrementally synchronizes data from one MySQL cluster to another MySQL cluster.
  • Bidirectional data synchronization: fully or incrementally synchronizes data between two MySQL clusters.
  • Synchronization of shards to the merged table: synchronizes MySQL sharded tables to the merged table. You can specify the corresponding relationship between the source table and the destination table.
  • Online data mutation: supports data changes during the replication. For example, you can rename, encrypt, and decrypt columns.


  • Input support
MySQL Binlog
MySQL Scan
Mongo Oplog
TiDB BinlogDoing
PostgreSQL WALDoing
  • Output support
  • Data mutation support
Filter data
Rename columns
Delete columns

For information about the architecture, visit:


The binlog format of the data source can only be row.

Configuration file example

# 'name' specifies the cluster name. It is mandatory.
name = "mysql2mysqlDemo"

# Name of the database that stores information about binlog positions and heartbeats. The default value is '_gravity'. This database is automatically generated on the data source.
internal-db-name = "_gravity"

# Define the input plugin. The following uses 'mysql' as an example.
# Type of the databases used for synchronization.
type = "mysql"
# Synchronization task type. Possible values are 'stream', 'batch', and 'replication'. 'stream' specifies incremental synchronization, 'batch' specifies full synchronization, and 'replication' specifies both full synchronization and incremental synchronization.
mode = "replication"
host = ""
username = "zz"
password = "********"
port = 3307

# Define the output plugin. The following uses 'mysql' as an example.
type = "mysql"
host = ""
username = "root"
password = "********"
port = 3306

# Define routing rules.
match-schema = "zg"
match-table = "test_source_table"
target-schema = "zg"
target-table = "test_target_table

Deployment schemes

Deploy Gravity on a Docker container

docker run -d -p 8080:8080 -v ${PWD}/config.toml:/etc/gravity/config.toml  --net=host --name=innodb2stone moiot/gravity:latest

Deploy Gravity on a Kubernetes container

wget -C gravity-operator-0.3.12.tar.gz
tar -zxvf gravity-operator-0.3.12.tar.gz

cd gravity-operator/charts/gravity-operator
helm install --name gravity-operator ./

Then perform the following steps to create a synchronization task:

  1. On the Kubernetes dashboard, check that Gravity is running properly and find the port corresponding to admin web-server.
  2. Use the port to log in to Gravity.
  3. Configure the template to create the synchronization task.

The parameters that you need to configure in the template are similar to those provided in the configuration file example.

Deploy Gravity on an ECS

We do not recommend this scheme because it requires preparations of the Golang environment and the compilation is complex.

git clone

cd gravity && make
bin/gravity -config mysql2mysql.toml

Configure monitoring for synchronization tasks

Add Gravity to Prometheus to monitor synchronization tasks. The following code provides an example.

- job_name: "gravity_innodb2stone"
- targets: [""]
instance: innodb2stone

The following are two screenshot examples of the Grafana monitoring dashboard. For details about display templates of Grafana, visit

Example 1:


Example 2: