Amazon Elastic Compute Cloud
User Guide (API Version 2013-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Monitoring Instances with Status Checks

With instance status monitoring you can quickly determine whether Amazon EC2 has detected any problems that may prevent your instances from running applications. Amazon EC2 performs automated checks on every running Amazon EC2 instance to identify hardware and software issues. You can view the results of these status checks to identify specific and detectable problems. This data augments the information that Amazon EC2 already provides about the intended state of each instance (pending, running, stopping, etc.) as well as the utilization metrics that Amazon CloudWatch monitors (CPU utilization, network traffic, and disk activity).

Status checks are performed every five minutes and each returns a pass or a fail status. If all checks pass, the overall status of the instance is OK. If one or more checks fail, the overall status is impaired. Status checks are built into Amazon EC2, so they cannot be disabled or deleted. You can, however create or delete alarms that are triggered based on the result of the status checks. For example, you can create an alarm to warn you if status checks fail on a specific instance. For more information, see Creating and Editing Status Check Alarms.

There are two types of status checks: system status checks and instance status checks.

System status checks monitor the AWS systems required to use your instance to ensure they are working properly. These checks detect problems with your instance that require AWS involvement to repair. When a system status check fails, you can choose to wait for AWS to fix the issue or you can resolve it yourself (for example, by stopping and restarting or terminating and replacing an instance). Examples of problems that cause system status checks to fail include:

  • Loss of network connectivity

  • Loss of system power

  • Software issues on the physical host

  • Hardware issues on the physical host

Instance status checks monitor the software and network configuration of your individual instance. These checks detect problems that require your involvement to repair. When an instance status check fails, typically you will need to address the problem yourself (for example by rebooting the instance or by making modifications in your operating system). Examples of problems that may cause instance status checks to fail include:

  • Failed system status checks

  • Misconfigured networking or startup configuration

  • Exhausted memory

  • Corrupted file system

  • Incompatible kernel

Note

Status checks that occur during instance reboot or while a Windows instance store-backed instance is being bundled will report an instance status check failure until the instance becomes available again.

Viewing Status

AWS provides you with several ways to view and work with status checks: You can use the AWS Management Console, interact directly with the API, or use the command line interface.

AWS Management Console

To view status checks

  1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

  2. In the Navigation pane, click Instances.

  3. On the Instances page, the Status Checks column lists the operational status of each instance.

    Viewing status
  4. To view an individual instance’s status, select the instance, and then click the Status Checks tab.

    Viewing status

Note

If you have an instance with a failed status check and the instance has been unreachable for over 20 minutes, you can click Contact Support to submit a request for assistance. To try and troubleshoot system or instance status check failures yourself, see Troubleshooting Instances with Failed Status Checks.

Command Line Tools

To do thisRun this command

Get the status of all instances

ec2-describe-instance-status

Get the status of all instances with a instance status of impaired

ec2-describe-instance-status --filter "instance-status.status=impaired"

Get the status of all instances with a single instance with instance ID i-15a4417c

ec2-describe-instance-status status –i-15a4417c

For more information about using the ec2-describe-instance-status command, see ec2-describe-instance-status in the Amazon Elastic Compute Cloud Command Reference Guide.

Note

If you have an instance with a failed status check, see Troubleshooting Instances with Failed Status Checks

API

You can use the DescribeInstanceStatus action to retrieve the status of your instances. For more information, see DescribeInstanceStatus in the Amazon Elastic Compute Cloud API Reference Guide.

Reporting Status

You can provide feedback about your instances if you are having problems with an instance whose status is not shown as impaired, or to send AWS additional details about the problems you are experiencing with an impaired instance.

We use reported feedback to identify issues impacting multiple customers, but do not respond to individual account issues reported via this form. Providing feedback will not change the status check results that you currently see for this instance.

If you are in need of technical assistance specific to your account, please post your question to the Developer Forums or contact Premium Support.

AWS Management Console

To report status feedback using the management console

  1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

  2. In the Navigation pane, click Instances.

  3. On the Instances page, click on the instance on which you want to report status.

  4. Click the Status Checks tab and then click the Submit Feedback button.

    Viewing status
  5. Complete the information on the Report Instance Status page.

    Viewing status

Command Line Tools

Use the ec2-report-instance-status command to send status feedback using the command line tools. The command uses the following syntax:

ec2-report-instance-status [instance_id ...] [--status ...] [--reason] ..]

For more information about using the ec2-report-instance-status command, see ec2-report-instance-status in the Amazon Elastic Compute Cloud Command Reference Guide.

API

You can use the ReportInstanceStatus action to submit feedback about a running instance's status. If your experience with the instance differs from the instance status returned by the DescribeInstanceStatus action, use ReportInstanceStatus to report your experience with the instance. Amazon EC2 collects this information to improve the accuracy of status checks. For more information, see ReportInstanceStatus in the Amazon Elastic Compute Cloud API Reference Guide.