Skip to main content

Documentation Index

Fetch the complete documentation index at: https://artie.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

To run Artie with DocumentDB, you must have SSH tunnels enabled or use BYOC with VPC peering as DocumentDB only allows access within your VPC.

Required settings

  • Cluster endpoint
  • Port (default is 27017)
  • Service account
  • Database name (ensure the database has change stream enabled)
You can find the cluster endpoint by going to the AWS console, selecting the DocumentDB cluster and go to the “Configuration” tab.DocumentDB cluster endpoint

Setting up change streams and a service account

setup.js
// Creating a service account for Artie to subscribe to change stream
db.createUser({user: "artie", pwd: "changeme", roles: ["read"]});
// Grants access to DocumentDB change streams
use admin;
db.grantRolesToUser("artie", [
  { role: "readAnyDatabase", db: "admin" }
]);

// Depending on the permission granularity you want, 
// you can use the following commands to grant permissions to the service account.
// Enable change streams for all collections in database "changeme"
db.adminCommand({
    modifyChangeStreams: 1,
    database: "changeme",
    collection: "",
    enable: true
});

// Enable change streams for all collections in all databases
db.adminCommand({
    modifyChangeStreams: 1,
    database: "",
    collection: "",
    enable: true
});

// Optional - Enable change streams for the collection "foo" in database "changeme"
db.adminCommand({
    modifyChangeStreams: 1,
    database: "changeme",
    collection: "foo",
    enable: true
});