How do I resolve a yellow or red health status warning in my Elastic Beanstalk environment?
Last updated: 2020-01-29
The health status in my AWS Elastic Beanstalk environment is in yellow (Warning) or red (Degraded or Severe) status. How can I get my health status back to green (OK)?
A yellow or red health status warning in your Elastic Beanstalk environment can result from some of these common issues:
- The health agent is reporting an insufficient amount of data on an Amazon Elastic Compute Cloud (Amazon EC2) instance.
- An operation is in progress on an instance within the command timeout.
- An Elastic Beanstalk environment is updating.
- Load balancer health checks are failing.
- The health agent is reporting a high number of request failures.
- An environment resource, such as an instance, is unavailable.
- An operation on an instance is taking a long time.
- An instance is in a Severe state.
- The Elastic Beanstalk health daemon failed.
- The Elastic Beanstalk environment failed one or more health checks.
- Elastic Beanstalk is receiving an increased number of 4xx or 5xx HTTP return codes.
- There are deployment failures with command timeouts.
For more information on warnings, see Health colors and statuses.
Identify the cause of the health warning
- Open the Elastic Beanstalk console.
- Choose your application.
- In the navigation pane, choose Events.
- In the Type column, look for recent events with a Severity type of WARN, and then note these events for troubleshooting later on.
- In the navigation pane, choose Dashboard.
- In the Health section, choose Causes.
Now, you can view the overall health of your environment on the Enhanced Health Overview page.
For more information, see Enhanced health monitoring with the environment management console.
Troubleshoot the issue that caused the health warning
Based on the health issues that you identify in the Enhanced Health Overview page, choose one of the following troubleshooting approaches:
- For health check failures, see Basic health reporting, or see Enhanced health reporting and monitoring if you're using enhanced health reporting.
For operations that are taking too long, identify the operation in progress using the Elastic Beanstalk event stream. Or, monitor the /var/log/eb-activity.log by logging in to your Amazon EC2 instance.
Note: Operations that take longer than usual are typically environment deployments or configuration updates.
- For an increased number of 4xx and 5xx HTTP return codes, identify the cause of the increase by monitoring the access logs of the proxy server. Then, compare the access logs with the application logs to identify the pattern of increased errors. For more information, see Common Errors.
Note: The proxy server logs can be the Apache access logs (/var/log/httpd/access_log), NGINX access logs (/var/log/nginx/access_log), or Internet Information Services access logs (C:\inetpub\logs\LogFiles), depending on your platform.
- For instances in a Severe state, choose a solution based on the warning issued. For more information, see Troubleshooting instances.
Note: Your instances can be in a Severe state due to an ongoing deployment, failure of the health daemon on the Amazon EC2 instance, or high resource utilization. In most cases, the warning state in your environment is temporary, and the state transitions to green (OK) after you address the issue that caused the health warning. For more information, see Health colors and statuses.
- For a failed Elastic Beanstalk health daemon, log in to your Amazon EC2 instance and monitor /var/log/messages to identify the cause of the failure.