This article will help you:
Often, business needs dictate that behavioral data be analyzed alongside other organizational sources of data that aren’t captured within Amplitude. By integrating Amplitude with Amazon S3, you'll be able to easily export your Amplitude data to an Amazon S3 bucket, enabling you to analyze your Amplitude data sets side-by-side with data sourced elsewhere.
Because the export works on a per-project basis, teams have the flexibility to set up data from one project for delivery to multiple buckets, or use multiple projects in the same organization to export event data into a single Amazon S3 bucket. (Each bucket can only be accessed by a single organization, however.)
NOTE: Currently, portfolio projects cannot be used as data sources for the Amazon S3 export.
This feature is available to all paying customers.
Set up the integration
To set up the Amazon S3 integration, follow these steps:
- Navigate to the Data Destinations panel.
- Scroll down to the Add More Destinations section and find the Amazon S3 data destination.
- Click the Amazon S3 card to open the Getting Started tab of the setup wizard.
- Choose which data you'd like to include in this export: export events ingested today and moving forward, export all merged Amplitude IDs, or export both. Click Next when you're ready to continue.
- Amplitude will open the Set Up Bucket Policy tab.
Go through the steps listed in the Create a Bucket and Add a Bucket Policy sections. Then fill out the required information in the S3 Bucket Information section.
- Click Generate Bucket Policy. Click Copy to copy the bucket policy to the clipboard, if desired. Then click Next when you're ready to continue.
Amplitude will then verify your bucket access.
Once your access has been verified, Amplitude will immediately commence with hourly automatic exports.
Run a manual export
You can backfill historical data to S3 by manually exporting data. To do so, select the desired date range, then click Start Export:
Once setup is complete, it's easy to check the status of your exports from within the integration itself.
Disable automatic exports
You can always disable automatic exports, from inside the Manage Export Settings modal.
To access it, open the integration and click Manage.
How long does it take for the export to complete?
The export will finish within one hour after the currently exported hour. The export time is typically between one and 10 minutes.
What potential errors might occur, and how will I be alerted to them?
The only potential error is an accessibility error. This can happen if you have changed any configurations on the receiving end, and Amplitude is unable to access to your bucket. In this case, the export will fail after several tries, and the Admin and the user who created the S3 export will be notified via email.
How do I troubleshoot errors?
Troubleshooting information is not available within the Amplitude UI, but information will be provided in the error email. Because accessibility is the only error possible, the email will include information on which permission is missing.
Is there a limit in size or date range when backfilling historical event data (via manual exports)?
No. If for any reason you are unable to export a certain date range, please confirm that you have event data for that date range and submit a ticket to our support team.