Concept
Activity Sync for Kinesis

Alex Pribula
Alex Pribula
  • Updated

Activity Sync allows you to stream experience and event data from your Pendula tenant to an Amazon Kinesis data stream, which can then be stored in an S3 bucket for reporting or analytics.

Need help with the full AWS setup? Follow our complete guide for configuring Amazon Kinesis and S3 before using these options in Pendula.

AWS access key ID

The AWS access key ID is used to authenticate your Amazon Kinesis connection. It identifies the IAM user that Pendula will use to send data to your Kinesis data stream.

The access key ID works together with the AWS secret access key to securely connect your Pendula tenant to Amazon Kinesis.

Important: The IAM user must have permissions to write to your Kinesis data stream. See our full setup guide for the required policy.

AWS secret access key

The AWS secret access key works with your access key ID to securely authenticate your Amazon Kinesis connection.

This value acts like a password — it should be stored securely and never shared. You will need both the access key ID and secret access key to set up your connection in Pendula.

Important: Pendula cannot retrieve this key once saved. If you lose it, a new access key must be created in your AWS account.

pendula-kinesis-2.png

Stream name

Enter the name of your Amazon Kinesis data stream. This should match the name you configured in your AWS account.
The stream must already exist and be accessible with the credentials provided.

Stream region

Select the AWS region where your Kinesis data stream is hosted.
This ensures Pendula sends data to the correct AWS region.

Enabled state (on)

When Activity Sync is on, Pendula will stream selected experience and event data to your configured Kinesis stream.
The toggle will appear active, and additional fields (stream name and region) will be required.

Disabled state (off)

When Activity Sync is disabled, no event data will be streamed to your Kinesis stream.
You can enable Activity Sync at any time by toggling the option on and providing the required details. The Kinesis stream only emits events when it is turned on (events are not queued while a sync is turned off).

Paused or Errored state

If Pendula detects an issue with your Activity Sync configuration, you may see an error status on the connection.

In this case:

  • Review your stream name, region, and credentials
  • Use the Retry connection option to attempt re-establishing the connection

Upgrading your Activity Sync version

v0.0.png

When a new version of Activity Sync is available:

  • Manage the connection you want to upgrade
  • Click the 'Configure' button next to the version
  • Select the version from the dropdown
  • New versions may introduce additional events

Always review the Activity Sync event documentation for details about new versions and compatibility as, once the connection saved, the version will be immediately upgraded.