4.1.7 Debug Service Integration Issues

Debug Service Integration Issues

Common Integration Issues

IssueCauseSolution
Lambda 502 from API GWWrong response formatReturn statusCode, headers, body
Lambda 504 from API GWTimeout > 29sOptimize or use async
Lambda no internet in VPCNo NAT GatewayAdd NAT GW or VPC Endpoint
DynamoDB throttlingHot partitionBetter key design, on-demand
SQS reprocessingVisibility timeout too shortSet ≥ 6x Lambda timeout
Kinesis IteratorAge ↑Consumer too slowIncrease parallelization factor

Debugging Checklist

1. CloudWatch Logs → Error messages, stack traces
2. CloudWatch Metrics → Throttling, errors, latency
3. X-Ray → Request path, bottleneck service
4. CloudTrail → API calls, permission denied
5. VPC Flow Logs → Network connectivity

DynamoDB Issues

ErrorCauseFix
ProvisionedThroughputExceededExceptionHot partition / low capacityBetter keys, on-demand
ValidationExceptionItem > 400KBReduce item size
ConditionalCheckFailedExceptionCondition not metHandle in code

SQS Issues

IssueFix
Messages reprocessedVisibility timeout ≥ 6x Lambda timeout
Messages in DLQFix consumer, redrive
Duplicates (Standard)Idempotency or FIFO

Kinesis Issues

IssueFix
IteratorAge increasingParallelization factor, optimize code
ReadProvisionedThroughputExceededEnhanced fan-out

Exam Tip: SQS visibility timeout ≥ 6x Lambda timeout. DynamoDB throttling = hot partition. Kinesis IteratorAge = consumer lag. Lambda VPC no internet = NAT Gateway.