Gremlin Destination Plugin

This destination plugin lets you sync data from any CloudQuery source to a Gremlin compatible graph database such as AWS Neptune.

Supported database (tested) versions (We use the official Go driver (opens in a new tab)):

• Gremlin Server >= 3.6.2
• AWS Neptune >= 1.2

As a side note graph databases can be quite useful for various networking use-cases, visualization, for read-teams, blue-teams and more.

Configuration

Example

This example configures a Gremlin destination, located at ws://localhost:8182. The username and password are stored in environment variables.

kind: destination
spec:
  name: "gremlin"
  registry: "github"
  path: "cloudquery/gremlin"
  version: "v2.1.0"
  # batch_size: 10000 # optional
  # batch_size_bytes: 5242880 # optional
  spec:
    endpoint: "ws://localhost:8182"
    auth_mode: "basic"
    username: "${GREMLIN_USERNAME}"
    password: "${GREMLIN_PASSWORD}"

The (top level) spec section is described in the Destination Spec Reference.

The Gremlin destination utilizes batching, and supports batch_size and batch_size_bytes.

Connecting to AWS Neptune

For AWS Neptune, you don't need to specify any credentials if IAM authentication is not enabled. Keep auth_mode at none.

If IAM authentication is enabled, you need to set auth_mode to aws and aws_region to the region of the database. The plugin will use the default AWS credentials chain to authenticate.

Plugin Spec

This is the (nested) spec used by the Gremlin destination Plugin.

• endpoint (string, required)

  Endpoint for the database. Supported schemes are wss:// and ws://, the default port is 8182.

  • "localhost" (defaults to wss://localhost:8182)
  • "ws://localhost:8182"
  • "wss://your-endpoint.cluster-id.your-region.neptune.amazonaws.com"

• insecure (boolean, optional)

  Whether to skip TLS verification. Defaults to false. This should be set on a MacOS environment when connecting to an AWS Neptune endpoint.

• auth_mode (either none, basic or aws, default: none)

  Authentication mode to use. basic uses static credentials, aws uses AWS IAM authentication.

• username (string, optional)

  Username to connect to the database.

• password (string, optional)

  Password to connect to the database.

• aws_region (string, required when auth_mode is aws)

  AWS region to use for AWS IAM authentication.

• max_retries (integer, optional. default: 5)

  Number of retries on ConcurrentModificationException before giving up for each batch. Retries are exponentially backed off.

• max_concurrent_connections (integer, optional. default: number of runtime processors)

  Maximum number of concurrent connections to the database.

• complete_types (boolean, optional. default: false)

  Whether to use all Gremlin-supported types or just a basic set. Should remain false for Amazon Neptune compatibility.