> ## Documentation Index > Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt > Use this file to discover all available pages before exploring further. # AWS S3 Event Ent+ This feature is available as an add-on for the [Honeycomb Enterprise plan](https://www.honeycomb.io/pricing/). Please contact your Honeycomb account team for details. The AWS S3 Event Receiver consumes S3 event notifications for object creation events (`s3:ObjectCreated:*`) and emits the S3 object as the string body of a log record. ## Supported Platforms | Platform | Supported | | -------- | --------- | | Linux | ✓ | | Windows | ✓ | | macOS | ✓ | Available in the Bindplane Distro for OpenTelemetry Collector `v1.74.0+`. ## Prerequisites * An AWS account with access to S3 and SQS. * An SQS queue configured to receive S3 event notifications. 1. Ensure the collector has permission to read and delete messages from the SQS queue. 2. Ensure the collector has permission to read objects from the S3 bucket. ## How It Works 1. The receiver polls an SQS queue for S3 event notifications. 2. When an object creation event (`s3:ObjectCreated:*`) is received, the receiver downloads the S3 object. 3. The receiver reads the object into the body of a new log record. 4. Non-object creation events are ignored but removed from the queue. 5. If an S3 object is not found (404 error), the corresponding SQS message is preserved for retry later. ## Configuration Fields

Field	Type	Default	Required	Description
sqs\_queue\_url	string		`true`	The URL of the SQS queue to poll for S3 event notifications.
standard\_poll\_interval	duration	15	`false`	The interval (in seconds) at which the SQS queue is polled for messages.
max\_poll\_interval	duration	2	`false`	The maximum interval (in seconds) at which the SQS queue is polled for messages.
polling\_backoff\_factor	float	2	`false`	The factor by which the polling interval is multiplied after an unsuccessful poll.
workers	int	5	`false`	The number of workers to process events.
visibility\_timeout	duration	300	`false`	How long (in seconds) messages received from the queue will be invisible to other consumers.
visibility\_extension\_interval	duration	1m	`false`	How often to extend message visibility during processing. Should be less than visibility\_timeout. Minimum is 10s.
max\_visibility\_window	duration	1h	`false`	Maximum total time a message can remain invisible before becoming visible to other consumers. Must be less than SQS's 12-hour limit.
max\_log\_size	int	1048576	`false`	The maximum size of a log record in bytes. Logs exceeding this size will be split
max\_logs\_emitted	int	1000	`false`	The maximum number of log records to emit in a single batch. A higher number will result in fewer batches, but more memory.
bucket\_name\_filter	string		`false`	When set, the source will only emit logs for bucket names that match the specified regex.
object\_key\_filter	string		`false`	When set, the source will only emit logs for object names that match the specified regex.
notification\_type	enum	`s3`	`false`	Options are `s3` and `sns`. S3 notifications are the default for S3 to SQS. SNS is for S3 notifications sent via SNS to SQS.
enable\_offset\_storage	bool	`false`	`false`	When enabled, the current position into an object will be saved to Redis, and reading will resume from where it left off after a collector restart.
redis\_hostname	string		`false`	The hostname or IP address of the Redis server used for offset storage.
redis\_port	int	6379	`false`	The port number of the Redis server used for offset storage.
redis\_password	string		`false`	The password for the Redis server used for offset storage.
redis\_database	string		`false`	The Redis database number to use for offset storage.
redis\_expiration	int	0	`false`	The expiration time (in seconds) for offset storage in Redis.
redis\_tls\_enabled	bool	`false`	`false`	Whether to enable TLS for the Redis connection.
redis\_tls\_ca\_file	string		`false`	The path to the CA file for Redis TLS connection.
redis\_tls\_cert\_file	string		`false`	The path to the client certificate file for Redis TLS connection.
redis\_tls\_key\_file	string		`false`	The path to the client key file for Redis TLS connection.

## Component Telemetry This component emits telemetry that can provide insight into how it is performing. The collector is configured to emit these metrics to `localhost:8888/metrics` by default.

Metric Name	Type	Description
otelcol\_s3event\_batch\_size	histogram	The number of logs in a batch.
otelcol\_s3event\_objects\_handled\_total	counter	The number of S3 objects processed by the receiver.
otelcol\_s3event\_failures\_total	counter	The number of failures encountered while processing S3 objects.