Skip to main content

Integrating AWS S3 buckets with Atomic

Write Atomic analytics batch files to an AWS s3 bucket

Preview release

Writing analytics files to S3 is currently in preview.

Contact us if you have any feedback.

Atomic can be configured to save hourly analytics batch files to an S3 bucket in your AWS account.

This can be configured to send in the following formats:

  • newline delimited JSON
  • CSV
  • Parquet

Steps to connect an S3 bucket with Atomic for saving analytics

  1. Login to your Workbench environment
  2. Navigate to Configuration > Integrations > AWS
  3. Click Connect bucket in the section titled: Write Atomic Analytics batch files in AWS S3
S3 integration configuration in the Workbench
Write Atomic analytics batch files in AWS S3 configuration in the Workbench
  1. Take note of the text next to Your bucket name must end with as this needs to be used when you create a bucket in S3
S3 integration configuration in the Workbench
Take note of the text and enter it at the end of your bucket name in S3.
  1. In AWS, create a new bucket appending the text from step 4 on the end of the bucket name.
S3 integration configuration in the Workbench
Naming a bucket in S3 with the suffix from the Atomic Workbench.
  1. Back in Atomic Workbench enter the Bucket name from step 5 and make sure the Bucket region is the same as created in step 5.
Note

The region and bucket name must be exactly the same as the permission policy is dynamic and uses the name supplied.

  1. Copy the policy from the Atomic workbench to your AWS S3 bucket by selecting the Permissions tab for your bucket and pasting the policy from Atomic into the Bucket policy section, once you have clicked the edit button.
  2. Configure the remaining data settings to suit your needs, including selecting the Analytic events you want to subscribe to.
  3. Click connect.

This will connect your S3 bucket with Atomic analytics and push analytics files, in the format you selected in the Data settings, every hour.