Event stream settings - Amazon Pinpoint

Event stream settings

Use the Event stream settings page to enable or disable streaming of usage and engagement data, known as event data, for the current project to supported AWS services. If you enable streaming, you can also choose the type of stream and the AWS Identity and Access Management role that you want to use.

Note

If you haven't already created an Amazon Kinesis stream, go to the Amazon Kinesis console at https://console.aws.amazon.com/kinesis. For more information about creating streams, see the Amazon Kinesis Data Streams Developer Guide or the Amazon Data Firehose Developer Guide.

Verify you have the permissions to setup and send to the stream. For more information about permissions see IAM role for streaming events to Kinesis

To set up event streaming

  1. Sign in to the AWS Management Console and open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.

  2. On the All projects page, choose the project that you want to set up data streaming for.

  3. In the navigation pane, under Settings, choose Event stream.

  4. In the Services section, choose Edit.

  5. Choose Stream to Amazon Kinesis.

  6. Under Choose a stream type, choose one of the following options:

    • Send events to an Amazon Kinesis Data Stream – Choose this option if you want to send Amazon Pinpoint event data to an external application for analysis.

    • Send events to an Amazon Data Firehose stream – Choose this option if you want to send event data to an AWS data store, such as Amazon Redshift.

  7. For Amazon Kinesis stream, choose the Amazon Kinesis stream that you want to use to export the data.

    Note

    If you haven't already created an Amazon Kinesis stream, go to the Amazon Kinesis console at https://console.aws.amazon.com/kinesis. For more information about creating streams, see the Amazon Kinesis Data Streams Developer Guide or the Amazon Data Firehose Developer Guide.

  8. Under IAM role, choose one of the following options:

    • Use an existing role – Choose this option to have Amazon Pinpoint assume an IAM role that already exists in your account. The role that you select must allow the firehose:PutRecordBatch action. For an example of a policy that allows this action, see Permissions Policies in the Amazon Pinpoint Developer Guide.

    • Automatically create a role – Choose this option to automatically create an IAM role with the required permissions. This role authorizes Amazon Pinpoint to send data to the stream that you chose in step 7.

  9. Choose Save.

As Amazon Pinpoint receives events for your project, it sends this data to your Kinesis stream. For information about the data that Amazon Pinpoint sends for an event, see Streaming Amazon Pinpoint Events to Kinesis in the Amazon Pinpoint Developer Guide.