aws-ec2-debug

Diagnose EC2 connectivity, performance, and configuration issues with AWS CLI and CloudWatch.

Updated May 7, 2025
One-click install
npx skills add https://github.com/enchantednatures/.dotfiles --skill aws-ec2-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-ec2-debug
Source: https://github.com/enchantednatures/.dotfiles/tree/main/.config/opencode/skills/aws-ec2-debug
Command: npx skills add https://github.com/enchantednatures/.dotfiles --skill aws-ec2-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically diagnose EC2 connectivity, performance, and configuration problems to accelerate restoration of service and reduce firefighting.

Core Features & Use Cases

  • Status checks and state validation: Assess instance state, status checks, and maintenance events to locate root causes.
  • Network and security diagnostics: Verify security groups, network ACLs, routes, and public IP mapping to ensure reachability.
  • System & performance insights: Retrieve console output, system logs, and CloudWatch metrics to identify boot, disk, and resource issues.
  • Use scenarios: Unreachable instances, degraded performance, boot failures, or configuration drift requiring guided remediation.

Quick Start

Initiate the AWS EC2 debugging workflow on a failing or unreachable EC2 instance to begin the structured diagnostic process.

Frequently Asked Questions about aws-ec2-debug

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

FAQPage Schema
How do I debug an unreachable EC2 instance?

To debug an unreachable EC2 instance, you must systematically verify instance state, status checks, security groups, network ACLs, and route configurations. This diagnostic workflow uses AWS CLI, SSH, SSM, and CloudWatch to isolate the root cause of connectivity loss.

What is the best way to diagnose EC2 performance degradation?

Diagnosing EC2 performance degradation involves retrieving console output, system logs, and CloudWatch metrics to identify boot, disk, or resource exhaustion issues. This structured approach assesses system insights to pinpoint the underlying cause of degraded performance.

How do I check EC2 network configuration when an instance is unreachable?

Checking EC2 network configuration involves verifying security groups, network ACLs, routing tables, and public IP mapping to ensure reachability. This process confirms whether network or security misconfigurations are causing the instance to be unreachable.

Can I use AWS CLI and SSM to troubleshoot EC2 boot failures?

Yes, you can use AWS CLI and SSM to troubleshoot EC2 boot failures by retrieving console output and system logs. These tools help identify boot errors, configuration drift, and instance state issues without requiring direct network access.

Why does my EC2 instance fail status checks after a maintenance event?

EC2 instances may fail status checks after maintenance events due to underlying state changes or configuration drift. Assessing instance state, status checks, and maintenance event history through a systematic diagnostic workflow isolates the failure cause.