aws-troubleshoot

Diagnose EC2, ECS, Lambda, and RDS issues using CloudWatch logs and metrics.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill aws-troubleshoot-erwinv2k-tkg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-troubleshoot
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/incidentfox/local/claude_code_pack/skills/aws-troubleshoot
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill aws-troubleshoot-erwinv2k-tkg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Investigating AWS service failures often means digging through massive log volumes and scattered metrics without a clear method, wasting time during incidents. This Skill provides a structured troubleshooting methodology for common AWS services so you can isolate root causes faster. ## Core Features & Use Cases - CloudWatch Logs Strategy: Partition-first query patterns using aggregation, error-rate binning, and latency percentiles instead of dumping raw logs. - Service-Specific Playbooks: Symptom-to-cause tables for EC2, Lambda, ECS/Fargate, and RDS, each listing the first check, typical causes, and key CloudWatch metrics. - Common Error Patterns: Guidance for permission errors, throttling, and resource-not-found failures with concrete remediation steps. - Use Case: A Lambda function starts timing out in production. Follow the Lambda playbook to query CloudWatch Insights for timeout patterns, analyze cold start metrics, and determine whether memory allocation or an external dependency is the cause. ## Quick Start Use the aws-troubleshoot skill to investigate why my Lambda function is timing out and analyze its CloudWatch logs.

Frequently Asked Questions about aws-troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot AWS Lambda timeout errors?

Lambda timeouts are diagnosed by querying CloudWatch logs for 'Task timed out' messages and analyzing duration metrics. Common causes include slow external calls, cold starts, and insufficient memory allocation, which also affects CPU availability.

How to query CloudWatch logs without dumping all data?

Use aggregation queries first: filter for ERROR patterns and apply stats count by time bins to find error spikes. Then sample specific log entries only from the spike windows and compare against baseline periods.

What CloudWatch metrics should I check for EC2 performance issues?

Check CPUUtilization, NetworkIn/NetworkOut, DiskReadOps/DiskWriteOps, and StatusCheckFailed metrics for EC2 instances. High CPU or network saturation typically explains performance degradation, while failed status checks indicate deeper host problems.

Why does my ECS task keep failing after deployment?

ECS task failures usually stem from container crashes, resource limits, or image pull errors. List the tasks to check the stopped reason, then review the task's CloudWatch logs and container insights metrics for the specific failure.

What causes AccessDeniedException errors in AWS services?

AccessDeniedException and UnauthorizedAccess errors indicate the IAM role or policy attached to the service lacks required permissions. Verify the role's policy grants the specific API actions the service is attempting to call.