Troubleshooting

Progress checklist

• Can diagnose the common failure modes

Overview

Symptom	Diagnosis	Fix
Channel create rejected / not available	Stream is provisioned	Recreate stream as On-Demand
AccessDenied on create-channel	Missing iam:PassRole or lifecycle permissions	Grant kinesis:CreateChannel, kinesis:AssociateStreamsWithChannel, iam:PassRole
Channel FAILED	Role, bucket Region, or KMS mismatch	Read ChannelStatusReason, delete channel, fix, recreate
No objects after produce	Records before ACTIVE, or freshness wait	Confirm producer started after ACTIVE; wait 300–900s
AccessDenied in delivery	IAM prefix ≠ output key template	Align s3:PutObject resource with template prefix, or scope to bucket/*
Compression create error	Template missing extension placeholder	End OutputKeyTemplate with !{extension}
Empty S3 immediately after produce	Freshness window	Wait; not a failure
Replay flag error	Old blog used -streamName	Use -streamArn

References

• IAM permissions for data delivery
• Monitoring data delivery
• Output key template
• Quotas and constraints