Artie Transfer
Comment on page


In this section, we will go over how to gather your credentials and prepare your MongoDB server to start providing CDC logs.


We will be running Debezium to fetch CDC logs from MongoDB by using Change Streams which is a more performant and reliable approach than tailing the oplog.
MongoDB server must be in a replica set. If your deployment only has a standalone server, you can create a replica set with one member.
Need help? Check out this guide.

Finding your MongoDB settings

This is necessary so that we are able to run a Debezium deployment to subscribe to Change Events within your MongoDB cluster. To see additional configuration properties, please click here to see Debezium's documentation.
Default value
Connection string
Click here to see how to retrieve this.
No default.
Username for authentication into your database.
No default
Password for authentication into your database.
No default
Authentication source
MongoDB authSource (which database should we authenticate against)

Creating a new user

use admin;
# Creating a role to allow listing DBs and finding the changeStream
createRole: "listDatabases",
privileges: [
{ resource: { cluster : true }, actions: ["listDatabases"]}
roles: []
createRole: "readChangeStream",
privileges: [
{ resource: { db: "", collection: ""}, actions: [ "find", "changeStream" ] },
roles: []
# Creating a service account, assign permissions
user: 'artie',
pwd: 'artie',
roles: [
{ role: "read", db: <COLLECTION_NAME> },
{ role: "read", db: "local" },
{ role: "listDatabases", db: "admin" },
{ role: "readChangeStream", db: "admin" },
{ role: "read", db: "config" },
{ role: "read", db: "admin" }

Supported types

Types are sourced from the MongoDB extended JSON specification.
  • Array
  • Binary
  • Array
  • Boolean
  • ObjectID
  • Int32
  • Int64
  • Double
  • Decimal128
  • Code
  • CodeWScope
  • RegEx
  • Datetime
  • Timestamp
  • String

Running it yourself

Self-hosted notes:

These considerations are automatically handled for you if Artie Transfer is running a Debezium connector for you.
We are also actively working on reducing the amount of considerations required to support every possible configuration.
Last modified 25d ago