|
| 1 | +--- |
| 2 | +title: Amazon SQS |
| 3 | +sidebar_order: 3 |
| 4 | +description: >- |
| 5 | + Learn about Sentry's Amazon SQS data forwarder, which enables creating custom data pipelines with Sentry errors through AWS. |
| 6 | +--- |
| 7 | + |
| 8 | +<Alert> |
| 9 | +Data Forwarding is currently in a limited preview, and may not be accessible to all organizations. |
| 10 | +</Alert> |
| 11 | + |
| 12 | +Amazon SQS is a generic queueing service provided by Amazon Web Services that Sentry supports sending error events to. The SQS forwarder may be useful for building your own data pipelines that might require Sentry errors as a source to eventually compare with some other data living elsewhere. |
| 13 | + |
| 14 | +Sentry supports Amazon SQS as a first-party **Data Forwarder**, which currently only supports forwarding error events. For more details on Data Forwarding in general (including basic setup and overrides), check out the [Data Forwarding](/organization/integrations/data-forwarding/) documentation. |
| 15 | + |
| 16 | +## Installation |
| 17 | + |
| 18 | +Navigate to **Settings » Data Forwarding** and add a new forwarder. |
| 19 | + |
| 20 | +Ensure you have selected _Amazon SQS_ as the provider. For standard queues, the required fields are the **Queue URL**, **Region**, **Access Key**, and **Secret Key**. |
| 21 | +If you are using a FIFO queue (`.fifo` suffix on your Queue URL), you will also need to provide a **Message Group ID**. |
| 22 | + |
| 23 | +Optionally, you can also provide an **S3 Bucket** for storing events. This will allow forwarding of event payloads greater than 256KB, and the SQS message will contain the bucket URL for the event instead of the event payload itself. |
| 24 | + |
| 25 | + |
| 26 | + |
| 27 | +For an AWS Access Key and Secret Key, you can get these from the AWS IAM console. Navigate to **IAM > Users > [Your User] > Security credentials** and click on **Create access key**. |
| 28 | + |
| 29 | + |
| 30 | + |
| 31 | +For the Queue URL, Navigate to **Amazon SQS > Queues > [Your Queue]** and click on the name of the queue you'd like to use, or create a new one. Afterward, the details should be visible. This also apples to the S3 Bucket (if you are using one, **Amazon S3 > Buckets > [Your Bucket]**). |
| 32 | + |
| 33 | + |
| 34 | + |
| 35 | +If you are using an S3 Bucket, ensure it is in the same region as the SQS queue. |
| 36 | + |
| 37 | +The payload for the SQS message (or S3 bucket object) is identical to our standard API event payload, and will evolve over time. For more details on the format of this data, see our [API documentation](/api/events/retrieve-an-event-for-a-project/). |
| 38 | + |
| 39 | +Once you’ve filled in the required fields, and added any projects you'd like events forwarded for, click **Complete Setup**. These projects will now begin forwarding events to your SQS queue! |
| 40 | + |
| 41 | +If you modify any of the above details from the AWS console, you'll have to update the forwarder you've configured in Sentry as well, manually. |
| 42 | + |
| 43 | +If you wish to modify your forwarder configuration per project, you can do so by following the [Project Overrides documentation](/organization/integrations/data-forwarding/#project-overrides). |
| 44 | + |
| 45 | +## Troubleshooting |
| 46 | + |
| 47 | +- Unlike the other data forwarders, Sentry does not rate limit its sending of events to Amazon SQS. This is separate from the rate limit Amazon SQS enforces. Keep that in mind if you are noticing inconsistencies in your data, or missing events. |
| 48 | +- Double check that your specified region is correct, both when monitoring the queue/bucket in AWS, and configuring the forwarder in Sentry. Sentry expects the region in the format of `us-east-1`, `us-west-1`, etc. |
| 49 | +- If your Sentry event payloads are greater than 256KB and you have not provided an S3 Bucket, the event will _not_ be forwarded to your SQS queue. You'll need to setup an S3 Bucket for these events to be forwarded. |
| 50 | +- If you are using an S3 Bucket, ensure it is in the same AWS region as the SQS queue otherwise you may experience issues with forwarding events. |
0 commit comments