How do I troubleshoot an Elastic Beanstalk environment that’s in a Degraded or Severe state?

3 minute read

I want to use the AWSSupport-TroubleshootElasticBeanstalk AWS Systems Manager automation runbook to troubleshoot an AWS Elastic Beanstalk environment that’s in a Degraded or Severe state.

Short description

The AWSSupport-TroubleshootElasticBeanstalk runbook helps to troubleshoot an Elastic Beanstalk environment that's in a Degraded or Severe state. This runbook analyzes the following AWS resources that are associated with your Elastic Beanstalk environment:

  • The Configuration details for the load balancer, AWS CloudFormation stack, and Amazon Virtual Private Cloud (Amazon VPC). Also, configuration details for Amazon Elastic Compute Cloud (Amazon EC2) Auto Scaling group and Amazon EC2 instances.
  • The Network configuration issues with the associated security group rules, route tables, and network access control lists (ACLs) associated with your subnets.
  • The connectivity to the Elastic Beanstalk endpoints and public internet access.
  • The status of the load balancer.
  • The status of the Amazon EC2 instances.

The runbook also retrieves a log bundle from your Elastic Beanstalk environment and then optionally uploads the files to AWS Support. 


Note: Before you start the runbook, make sure that your AWS Identify and Access Management (IAM) user or role has the required permissions. For more information, see the Required IAM permissions section of AWSSupport-TroubleshootElasticBeanstalk.

Run the AWSSupport-TroubleshootElasticBeanstalk runbook

  1. Sign in to the Elastic Beanstalk console.
  2. Choose the AWSSupport-TroubleshootElasticBeanstalk runbook. Then, choose Execute automation.
  3. For the input parameters, enter the following:
    • AutomationAssumeRole (optional): Enter the ARN of the IAM role that allows automation to perform actions. If a role isn't specified, then automation uses the permissions of the user that starts the runbook.
    • ApplicationName (required): The name of your Elastic Beanstalk application.
    • EnvironmentName (required): The name of your Elastic Beanstalk environment.
    • AWSS3UploaderLink (optional): A URL provided to you by AWS Support to upload the log bundle from your Elastic Beanstalk environment. This option is only available to customers who have purchased an AWS Support plan and have opened a support case.
  4. Choose Execute. For a list of actions that the runbook performs, see the Document Steps section of AWSSupport-TroubleshootElasticBeanstalk.
  5. After the runbook completes, check the details of every action performed by the automation and the detected issues.

Note: To help you further troubleshoot, manage, and reduce costs of your AWS resources, use predefined runbooks that AWS Support provides for AWS Systems Manager. These runbooks have the AWSSupport or AWSPremiumSupport prefixes. For more information, see AWS Systems Manager Automation runbook reference.

Related information

Run an automation

Setting up Automation

AWS OFFICIALUpdated 5 months ago