> For the complete documentation index, see [llms.txt](https://upsolver.gitbook.io/content/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://upsolver.gitbook.io/content/quickstarts-1/data-ingestion-wizard/using-the-wizard/source-set-up/amazon-kinesis.md). # Amazon Kinesis ## Step 1 - Connect to Amazon Kinesis ### Create a new connection Click **Create a new connection**, if it is not already selected. Then select the **AWS region where your Kinesis is hosted** from the pre-populated list. For the **Authentication Method**, select either the **Role-based** or the **AccessKey/SecretKey** option: #### Role-based Upsolver recommends that you use **Role-based** access. * To define the correct permissions for the role, follow the [Kinesis access configuration](/content/how-to-guides-1/connectors/configure-access/amazon-kinesis.md) guide to create an IAM policy * If your Kinesis runs on a different AWS account than the one running Upsolver, you need to create trust between the role and the account running Upsolver. To create a trusted **AWS ROLE** and find your **External Id**, follow the [Role-Based AWS Credentials](/content/how-to-guides-1/setup/deploy-upsolver-on-aws/role-based-aws-credentials.md) guide. #### **AccessKey/SecretKey** To create your **Access key id** and **Secret access key**, follow the [AWS Account and Access Keys guide](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-appendix-sign-up.html). When you have entered your authentication information, click **Test Connection**.

Create a new connection to your Amazon Kinesis source to ingest your streaming data.

### Use an existing connection By default, if you have already created a connection, Upsolver selects **Use an existing connection**, and your Kinesis connection is populated in the list. For organizations with multiple connections, select the source connection you want to use.

Select an existing Amazon Kinesis connection to use as your source to ingest data from.

## Step 2 - Select a stream to ingest When the connection is established, a list of streams will appear in the select list, **Select a stream to ingest**. Then choose the file type you want to ingest in the **Select the source events content type** list, or leave it on the default value of **Automatic**. ## Step 3 - Check that events are read successfully As soon as you select a stream, Upsolver will attempt to load a sample of the events. If Upsolver did not load any sample events, try the following: 1. Verify that Kinesis has events. 2. Select a [content type](#step-2-select-a-stream-to-ingest) that matches the type of your stream. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://upsolver.gitbook.io/content/quickstarts-1/data-ingestion-wizard/using-the-wizard/source-set-up/amazon-kinesis.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.