Troubleshoot impaired Amazon EC2 Linux instance using EC2Rescue - Amazon Elastic Compute Cloud

Troubleshoot impaired Amazon EC2 Linux instance using EC2Rescue

EC2Rescue for Linux is an easy-to-use, open-source tool that can be run on an Amazon EC2 Linux instance to diagnose, troubleshoot, and remediate common issues using its library of over 100 modules. Modules are YAML files that contain either a BASH or a Python script and the necessary metadata.

Some generalized use cases for EC2Rescue for Linux instances include:

  • Gathering syslog and package manager logs

  • Collecting resource utilization data

  • Diagnosing and remediating known problematic kernel parameters and common OpenSSH issues

Note

The AWSSupport-TroubleshootSSH AWS Systems Manager Automation runbook installs EC2Rescue for Linux and then uses the tool to check or attempt to fix common issues that prevent an SSH connection to a Linux instance. For more information, see AWSSupport-TroubleshootSSH.

If you are using a Windows instance, see Troubleshoot impaired Amazon EC2 Windows instance using EC2Rescue.