> ## Documentation Index
> Fetch the complete documentation index at: https://www.edgee.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon S3

> Collect and forward analytics events to your data lake on Amazon S3.

<img src="https://mintcdn.com/edgee/enlt_qUyIUJ64Dg-/images/banners/aws-s3.png?fit=max&auto=format&n=enlt_qUyIUJ64Dg-&q=85&s=0db97513642f1304e9d6084df426eab3" className="rounded-lg" noZoom width="1312" height="334" data-path="images/banners/aws-s3.png" />

Find it on GitHub: [<Icon icon="github" iconType="solid" /> /edgee-ai/amazon-s3-component](https://github.com/edgee-ai/amazon-s3-component)

Amazon Simple Storage Service (Amazon S3) is an object storage service offered by Amazon Web Services.
It supports storing any amount of data for virtually any use case, such as data lakes, cloud-native applications,
and mobile apps.

## Event Mapping

Here's how Edgee events map to S3 objects:

| Edgee event | S3 object                            | Description    |
| ----------- | ------------------------------------ | -------------- |
| Page        | `{bucket}/{prefix}{random-key}.json` | Full JSON dump |
| Track       | `{bucket}/{prefix}{random-key}.json` | Full JSON dump |
| User        | `{bucket}/{prefix}{random-key}.json` | Full JSON dump |

## Getting Started

**To integrate Amazon S3 into your Edgee project:**

1. Open the Edgee console and navigate to your project's Components.
2. Select "Add a component" and choose `edgee/amazon-s3` from the list of available components.
3. Enter your AWS credentials, region, bucket name, optional prefix, and click Save. <br />
4. Once the component has been configured, you are ready to send analysis events to S3.

## Component Name

When configuring the component in your **Edgee Data Layer** or within SDK calls, use `edgee/amazon-s3` as the component name:

```json theme={"dark"}
{
  "components": {
    "edgee/amazon-s3": true
  }
}
```

For more details on Amazon S3 implementation, refer to the
[official S3 PutObject documentation](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).