Amazon Mobile Analytics
User Guide

Part 5: Connect to Amazon EC2 and Configure the Event Loader


After April 30, 2018, Amazon Mobile Analytics features will be provided only by Amazon Pinpoint. If you're new to Mobile Analytics, use Amazon Pinpoint instead. If you're currently using Mobile Analytics, see Migrating from Amazon Mobile Analytics to Amazon Pinpoint.

After configuring your Amazon EC2 access, you must connect to Amazon EC2.

  1. Log in to the Amazon EC2 instance through the AWS Management Console or through a terminal shell. For more information, see Connecting to Your Linux Instance Using SSH.

  2. Using a terminal shell, enter the following:

    $ chmod 400 YOUR_KEY_FILE.pem $ ssh -i YOUR_KEY_FILE.pem ec2-user@PUBLIC_DNS
  3. Configure the event loader on Amazon EC2 with the correct settings. Run the following commands, providing values for each of the properties:

    $ ~/DataExport/bin/configure Enter value for key: (DataReaderUser.password) -> a_password Enter value for key: ( -> redshift_host Enter value for key: (Redshift.database) -> redshift_database Enter value for key: (Redshift.port) -> redshift_port Enter value for key: (DataBackfill.startdate) -> s3_export_date Enter value for key: (CloudWatch.record_duration_metric) -> True Enter value for key: (EventDetails.custom_attributes) -> attr1,attr2 Enter value for key: (EventDetails.custom_metrics) -> metric1,metric2 Enter value for key: (S3Source.bucketname) -> s3_bucket_name Enter value for key: (ETLUser.password) -> a_password


  • In the event the configure script is not present in ~/DataExport/bin, you will need to log in to your Amazon EC2 instance and check the contents of /var/log/user-data.log to determine why the configure script was not downloaded during setup of the Amazon EC2 instance. For example, Python might not have installed correctly.

  • Amazon Redshift passwords must contain at least 1 upper case letter and 1 number.

  • DataReaderUser.password is the password for the eventreader Amazon Redshift user that's auto-created in the next step.

  • The, Redshift.database, and Redshift.port are found on the Amazon Redshift console from Step 2.

  • DataBackfill.startdate should be the format YYYY/MM/DD. Select the date you started exporting data to Amazon S3.

  • Custom attributes and metrics should be delimited with a comma with no spaces.

  • S3Source.bucketname should be just the name of Amazon S3 bucket, for example: mobile-analytics-02-01-2015-ef5dc9e30e4a49c9a4b0cb5c31629932

  • ETLUser.password is only used by the Amazon EC2 instance.

On this page: