- https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html
- https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3.html
- https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
- Data lake ingestion
- Long-term archival
- Regulatory compliance
- Machine learning datasets
- Batch analytics
- Disaster recovery backups
- Streams Kafka events into Amazon S3.
- Buffers events before upload for efficient storage.
- Supports JSON, NDJSON, and CSV output formats.
- Authenticates using AWS IAM credentials.
- Automatically retries failed uploads.
- Supports region-specific S3 buckets.
- The connector subscribes to the configured Kafka topic.
- Incoming events are buffered in memory.
- Files are generated according to configured batching policies.
- Generated files are uploaded to the specified Amazon S3 bucket.
- Upload status and operational metrics are available through Condense observability.
Field-by-Field Explanation
Title
- Description: Friendly name for the connector.
- Example:
S3_Event_Archive_Prod
Bucket Name
- Description: Target Amazon S3 bucket where files will be uploaded.
- Requirements:
- Bucket must already exist.
- IAM credentials must have write access.
- Example:
fleet-event-archive
Region
- Description: AWS Region where the bucket is hosted.
- Examples:
ap-south-1us-east-1eu-west-1
Access Key
- Description: AWS IAM Access Key ID used to authenticate with Amazon S3.
- Permissions Required:
s3:PutObjects3:ListBucket- Optionally
s3:GetObject
Secret Key
- Description: AWS Secret Access Key associated with the Access Key.
- Security Recommendation: Store credentials securely and rotate them regularly.
Input Topic
- Description: Kafka topic inside Condense from which events are consumed.
- Example:
vehicle.events.processed
Access Denied
Possible Causes- Missing IAM permissions.
- Incorrect AWS credentials.
- Verify the IAM user has
s3:PutObjectpermission. - Validate the configured Access Key and Secret Key.
Bucket Not Found
Possible Causes- Bucket name is incorrect.
- Incorrect AWS region.
- Verify the bucket exists.
- Ensure the configured region matches the bucket region.
Upload Failures
Possible Causes- Network connectivity issues.
- Temporary AWS service interruptions.
- Review connector logs.
- Retry after connectivity is restored.
Files Not Visible
Possible Causes- Objects uploaded under a different prefix.
- Verify object prefixes within the bucket.
- Check the generated object key structure.
Object Naming
By default, uploaded objects follow a timestamp-based folder hierarchy similar to:Supported Output Formats
Depending on upstream transformations, the connector supports:- JSON
- NDJSON
- CSV
Compression
Compression can be applied upstream using Condense transforms before data reaches the connector.Downstream AWS Integrations
Uploaded objects can be consumed by:- Amazon Athena
- AWS Glue
- Amazon EMR
- Amazon Redshift Spectrum
- AWS Lambda
- Amazon QuickSight
- Enable bucket versioning for recovery from accidental overwrites.
- Configure lifecycle policies to archive or delete old objects automatically.
- Use dedicated IAM users with least-privilege permissions.
- Organize data using date-based folder structures for efficient analytics.
- Monitor upload success, latency, and failures using Amazon CloudWatch and Condense observability.