AI-powered environment analysis - Amazon Elastic Beanstalk
How it worksPrerequisitesRequired permissionsUsing AI analysis in the consoleUsing AI analysis with the Amazon CLIImportant considerationsSupported platform versions
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AI-powered environment analysis

Amazon Elastic Beanstalk's AI-powered analysis identifies root causes and recommends solutions for environment health issues. When your environment experiences problems, you can request an AI analysis using the RequestEnvironmentInfo and RetrieveEnvironmentInfo API operations with the analyze info type to get AI-generated insights and recommended solutions.

Note

AI analysis is available only on supported Amazon Linux 2 and AL2023 platform versions released on or after February 16, 2026.

How it works

When you request an AI analysis, Elastic Beanstalk runs a script on an instance in your environment that collects recent events, instance health, and logs (up to 170,000 tokens of data). It then sends this data to Amazon Bedrock in your account and returns insights and recommended next steps.

Prerequisites

Before using AI analysis, ensure that your environment meets the following requirements:

Required permissions

To use AI analysis, the Amazon EC2 instance profile for your environment must have permissions to invoke Amazon Bedrock. Add the following permissions to your instance profile:

  • bedrock:InvokeModel

  • bedrock:ListFoundationModels

  • elasticbeanstalk:DescribeEvents

  • elasticbeanstalk:DescribeEnvironmentHealth

For more information about configuring instance profiles, see Managing Elastic Beanstalk instance profiles.

Using AI analysis in the console

From the environment overview

When your environment's health status is Warning, Degraded, or Severe, an AI Analysis button appears in the environment overview section. Click on this button to initiate an AI analysis of your environment.

From the Logs page

You can also access AI analysis from the Logs page in the navigation pane. Click on the AI Analysis button to request an AI-powered analysis of your environment's current state.

Using AI analysis with the Amazon CLI

You can use the Elastic Beanstalk API through the Amazon CLI to request and retrieve AI analysis programmatically.

Request AI analysis

Use the RequestEnvironmentInfo operation with the InfoType parameter set to analyze.

Example Amazon CLI - Request AI analysis
aws elasticbeanstalk request-environment-info \
    --environment-name my-env \
    --info-type analyze \
    --region us-east-1
Retrieve AI analysis

Use the RetrieveEnvironmentInfo operation with the InfoType parameter set to analyze to retrieve the analysis results.

Example Amazon CLI - Retrieve AI analysis
aws elasticbeanstalk retrieve-environment-info \
    --environment-name my-env \
    --info-type analyze \
    --region us-east-1

The response includes an AI-generated analysis of the current state of the environment. If any issues are identified, recommended solutions are presented.

Important considerations

  • Pricing – AI analysis uses Amazon Bedrock to process your environment data, and standard Amazon Bedrock pricing applies for model invocations. For pricing details, see Amazon Bedrock Pricing.

  • Platform requirement – AI analysis is available only on Amazon Linux 2 and AL2023 based platform versions released on or after February 16, 2026. To use this feature, update your environment to a supported platform version. For more information, see Updating your Elastic Beanstalk environment's platform version.

  • Permissions – Before using AI analysis, ensure that your instance profile has the required Amazon Bedrock permissions (bedrock:InvokeModel and bedrock:ListFoundationModels) and Elastic Beanstalk permissions (elasticbeanstalk:DescribeEvents and elasticbeanstalk:DescribeEnvironmentHealth).

  • Data privacy – The analysis sends environment events and logs to Amazon Bedrock in your account for processing. For information about how Amazon Bedrock handles your data, see Amazon Bedrock Security and Compliance.

  • Service quotas – AI analysis uses an Anthropic Claude model in Amazon Bedrock, which has default quotas for requests per minute and tokens per minute. If you encounter throttling errors, you can request a quota increase. For more information, see Requesting a quota increase.

Supported platform versions

AI analysis is supported on Amazon Linux 2 and AL2023 based platform versions released on or after February 16, 2026. To verify your platform version, see Elastic Beanstalk release notes.