debug-aws

What problem does it solve?

Provides a systematic, service-by-service troubleshooting workflow to diagnose and remediate AWS infrastructure issues affecting the portfolio deployment, reducing downtime and accelerating recovery for S3/CloudFront static site, ECS Fargate services, Lambda/API Gateway endpoints, RDS databases, and DNS/certificate problems.

Core Features & Use Cases

• Service identification: Maps observed symptoms (HTTP codes, DNS failures, task stops) to the most likely AWS service to inspect.
• Targeted diagnostics: Prescribes AWS CLI commands, CloudWatch checks, ALB/target health, ECS task logs, RDS status checks, ACM/Route53 validation, and Terraform state troubleshooting steps.
• Operational playbooks: Includes common fixes such as CloudFront invalidation, forcing ECS redeployments, checking Secrets Manager permissions, and resolving Terraform state drift.
• Use case: If /ai-evals returns 502, follow ECS and ALB health checks, inspect container logs and ECR images, verify IAM and security group connectivity, and redeploy or scale tasks as indicated.

Quick Start

Diagnose why the portfolio site is returning 502 errors for /ai-evals and request step-by-step AWS CLI checks, log locations, and remediation instructions.