Using the Elastic Beanstalk environment management console
The Elastic Beanstalk console provides an Environment overview page for you to manage each of your AWS Elastic Beanstalk environments. From the
Environment overview page, you can manage your environment's configuration and perform common actions. These actions include
restarting the web servers running in your environment, cloning your environment, or rebuilding your environment from scratch.
- Old console
-
- New console
-
We're releasing a new Elastic Beanstalk console experience.
The new console design is being released in a phased rollout to all regions that Elastic Beanstalk supports.
It’s presently available in the following AWS Regions:
Beta release in US East (N. Virginia)— us-east-1
Asia Pacific (Sydney) — ap-southeast-2
Europe (Frankfurt) — eu-central-1
Europe (Ireland) — eu-west-1
South America (São Paulo) — sa-east-1
For more information, see the March 22, 2023 Release Notes in the
AWS Elastic Beanstalk Release Notes guide.
To access the environment management console
Open the Elastic Beanstalk console,
and in the Regions list, select your AWS Region.
-
In the navigation pane, choose Environments, and then choose the name of your environment from the list.
If you have many environments, use the search bar to filter the environment list.
You see the Environment overview page. The console's navigation pane shows the name of the application where the environment
belongs, with related application management pages, and the environment name, with environment management pages.
Environment overview
To view the Environment overview page, choose the environment name on the navigation pane, if it's the current environment.
Alternatively, navigate to the environment from the Applications page or from the main environment list on the
Environments page.
The top pane on the environment overview page shows top-level information about your environment. This includes its name, URL, and current health
status, as well as the name of the currently deployed application version, and the platform version that the application is running on. You can see the
most recent environment events below the overview pane.
Choose Refresh to update the information shown. The overview page contains the following information and options.
- Old console
-
URL
The environment's URL is located at the top of the overview and below the environment name. This is the URL of the web
application that the environment is running.
Health
The overall health of the environment. With Enhanced health reporting and monitoring enabled, the environment status
is shown with a Causes button that you can choose to view more information about the environment's current status.
For Basic health reporting environments, a link to the Monitoring Console is shown.
Running version
The name of the application version that is deployed and running on your environment. Choose Upload and deploy to upload
a source bundle and deploy it to your environment. This option creates a new application
version.
Platform
The name of the platform version running on your environment. Typically, this comprises the architecture, operating system (OS), language, and
application server (collectively known as the platform branch), with a specific platform version number. Choose
Change to select a different platform version. This option is available only if another version of the platform branch is
available.
Updating the platform version using this option replaces instances running in your environment with new instances.
When you first use Elastic Beanstalk, only the latest (recommended) version of each platform branch is available for use. Change
first becomes available when a new platform version is released for the branch. After upgrading to the latest platform branch version, you have
the option to go back to a previous version.
Recent events
The Recent Events section of the environment overview page shows the most recent events emitted by your environment. This
list is updated in real time at the same time that your environment is updated.
Choose Show all to open the Events page.
- New console
-
Health
The overall health of the environment.
Domain
The environment's Domain, or URL, is located in the upper portion of the Environment overview page,
below the environment's Health. This is the URL of the web application that the environment is running.
Environment id
The environment ID. This is an internal ID that's generated when the environment is created.
Application name
The name of the application that is deployed and running on your environment.
Running version
The name of the application version that is deployed and running on your environment. Choose Upload and deploy to upload
a source bundle and deploy it to your environment. This option creates a new application
version.
Platform
The name of the platform version running on your environment. Typically, this comprises the architecture, operating system (OS), language, and
application server (collectively known as the platform branch), with a specific platform version number.
When a more recent version of the platform branch is available, the information displayed beneath Platform is underlined.
This indicates that you can select this text to display the Change platform version link. Select it to update your platform
version. When you first use Elastic Beanstalk, only the latest (recommended) version of each platform branch is available for use. Change platform
version first becomes available when a new platform version is released for the branch. After upgrading to the latest platform branch
version, you have the option to go back to a previous version. Updating the platform version using this option replaces instances running in your
environment with new instances.
Environment overview tabs
The tabs displayed on the bottom half of the page contain more detailed information about your environment and provide access to additional
features:
-
Events – Shows information or error messages from the Elastic Beanstalk service and from other services whose resources this
environment uses.
-
Health – Shows the status of and detailed health information about the Amazon EC2 instances running your
application.
-
Logs – Retrieve and download logs from the Amazon EC2 in your environment. You can retrieve full logs or recent
activity. The retrieved logs are available for 15 minutes.
-
Monitoring – Shows statistics for the environment, such as average latency and CPU utilization. You can use this
page to create alarms for the metrics that you are monitoring.
-
Alarms – Shows the alarms that you configured for environment metrics. You can add, modify or delete alarms on
this page.
-
Managed updates – Shows information about upcoming and completed managed platform updates and instance
replacement.
-
Tags – Shows environment tags and allows you to manage them. Tags are key-value pairs that are applied to your
environment.
The navigation pane on the left side of the console lists links with the same name as the tabs. Selecting any of these links will display the
contents of the corresponding tab.
Environment actions
The environment overview page contains an Actions menu that you can use to perform common operations on your environment. This
menu is shown on the right side of the environment header next to the Create a new environment option.
Some actions are only available under certain conditions, remaining disabled until the right conditions are met.
Load configuration
Load a previously saved configuration. Configurations are saved to your application and can be loaded by any associated environment. If you've made
changes to your environment's configuration, you can load a saved configuration to undo those changes. You can also load a configuration that you saved
from a different environment running the same application to propagate configuration changes between them.
Save configuration
Save the current configuration of your environment to your application. Before you make changes to your environment's configuration, save the
current configuration so that you can roll back later, if needed. You can also apply a saved configuration when you launch a new environment.
Swap environment Domains (URLs)
Swap the CNAME of the current environment with a new environment. After a CNAME swap, all traffic to the application using the environment URL goes
to the new environment. When you are ready to deploy a new version of your application, you can launch a separate environment under the new version.
When the new environment is ready to start taking requests, perform a CNAME swap to start routing traffic to the new environment. Doing this doesn't
interrupt your services. For more information, see Blue/Green deployments with Elastic Beanstalk.
Clone environment
Launch a new environment with the same configuration as your currently running environment.
Clone with latest platform
Clone your current environment with the latest version of the in-use Elastic Beanstalk platform. This option is available only when a newer version of the
current environment's platform is available for use.
Abort current operation
Stop an in-progress environment update. Stopping an operation can cause some of the instances in your environment to be in a different state than
others, depending on how far the operation progressed. This option is available only when your environment is being updated.
Restart app servers
Restart the web server that is running on your environment's instances. This option doesn't terminate or restart any AWS resources. If your
environment is acting strangely in response to some bad requests, restarting the application server can restore functionality temporarily while you
troubleshoot the root cause.
Rebuild environment
Terminate all resources in the running environment and build a new environment with the same settings. This operation takes several minutes, similar
to the amount of time needed for deploying a new environment from scratch. Any Amazon RDS instances that are running in your environment's data tier are
deleted during a rebuild. If you need the data, create a snapshot. You can create a snapshot manually in the RDS console or configure your data tier's Deletion Policy to create a snapshot
automatically before deleting the instance. This is the default setting when you create a data tier.
Terminate environment
Terminate all resources in the running environment and remove the environment from the application. If you have an RDS instance that is running in a
data tier and you need to retain its data, make sure the database deletion policy is set to either Snapshot
or
Retain
. For more information, see Database lifecycle in the
Configuring environments chapter of this guide.
Restore environment
If the environment has been terminated in the last hour, you can restore it from this page. After an hour, you can restore it from the application overview page.
Events
- Old console
-
The Events page shows the event stream for your environment. Elastic Beanstalk outputs event messages whenever you interact with the
environment, and when any of your environment's resources are created or modified as a result.
For more information, see Viewing an Elastic Beanstalk environment's event stream.
- New console
-
The Events tab shows the event stream for your environment. Elastic Beanstalk outputs event messages whenever you interact with the
environment, and when any of your environment's resources are created or modified as a result.
For more information, see Viewing an Elastic Beanstalk environment's event stream.
Health
- Old console
-
If enhanced health monitoring is enabled, the Enhanced health overview page shows live health information about every
instance in your environment. Enhanced health monitoring enables Elastic Beanstalk to closely monitor the resources in your environment so that it can assess
the health of your application more accurately.
When enhanced health monitoring is enabled, this page shows information about the requests served by the instances in your environment and
metrics from the operating system, including latency, load, and CPU utilization.
For more information, see Enhanced health reporting and monitoring.
- New console
-
If enhanced health monitoring is enabled this page shows live health information for your instances. The Overall health
pane shows health data as an average for all of your environment’s instances combined. The Enhanced instance health pane shows
live health information for each individual instance in your environment. Enhanced health monitoring enables Elastic Beanstalk to closely monitor the resources
in your environment so that it can assess the health of your application more accurately.
When enhanced health monitoring is enabled, this page shows information about the requests served by the instances in your environment and
metrics from the operating system, including latency, load, and CPU utilization.
For more information, see Enhanced health reporting and monitoring.
Logs
- Old console
-
The Logs page lets you retrieve logs from the EC2 instances in your environment. When you request logs, Elastic Beanstalk sends a
command to the instances, which then upload logs to your Elastic Beanstalk storage bucket in Amazon S3. When you request logs on this page, Elastic Beanstalk automatically
deletes them from Amazon S3 after 15 minutes.
You can also configure your environment's instances to upload logs to Amazon S3 for permanent storage after they have been rotated locally.
For more information, see Viewing logs from Amazon EC2 instances in your Elastic Beanstalk environment.
- New console
-
The Logs page lets you retrieve logs from the EC2 instances in your environment. When you request logs, Elastic Beanstalk sends a
command to the instances, which then upload logs to your Elastic Beanstalk storage bucket in Amazon S3. When you request logs on this page, Elastic Beanstalk automatically
deletes them from Amazon S3 after 15 minutes.
You can also configure your environment's instances to upload logs to Amazon S3 for permanent storage after they have been rotated locally.
For more information, see Viewing logs from Amazon EC2 instances in your Elastic Beanstalk environment.
Monitoring
- Old console
-
The Monitoring page shows an overview of health information for your environment. This includes the default set of metrics
provided by Elastic Load Balancing and Amazon EC2, and graphs that show how the environment's health has changed over time. You can use the options on this page to configure
additional graphs for resource-specific metrics, and add alarms for any metric supported by the in-use health reporting system.
For more information, see Monitoring environment health in the AWS management
console.
- New console
-
The Monitoring page shows an overview of health information for your environment. This includes the default set of metrics
provided by Elastic Load Balancing and Amazon EC2, and graphs that show how the environment's health has changed over time. You can use the options on this page to configure
additional graphs for resource-specific metrics, and add alarms for any metric supported by the in-use health reporting system.
For more information, see Monitoring environment health in the AWS management
console.
Alarms
- Old console
-
The Existing alarms page shows information about any alarms that you have configured for your environment. You can use the
options on this page to modify or delete alarms.
For more information, see Manage alarms.
- New console
-
The Existing alarms page shows information about any alarms that you have configured for your environment. You can use the
options on this page to create or delete alarms.
For more information, see Manage alarms.
Managed updates
- Old console
-
The Managed updates overview page shows information about upcoming and completed managed platform updates and instance
replacement.
The managed update feature lets you configure your environment to update to the latest platform version automatically during a weekly
maintenance window that you choose. In between platform releases, you can choose to have your environment replace all of its Amazon EC2 instances during
the maintenance window. This can alleviate issues that occur when your application runs for extended periods of time.
For more information, see Managed platform updates.
- New console
-
The Managed updates overview page shows information about upcoming and completed managed platform updates and instance
replacement.
The managed update feature lets you configure your environment to update to the latest platform version automatically during a weekly
maintenance window that you choose. In between platform releases, you can choose to have your environment replace all of its Amazon EC2 instances during
the maintenance window. This can alleviate issues that occur when your application runs for extended periods of time.
For more information, see Managed platform updates.
For more information, see Managed platform updates.
- Old console
-
The Tags page shows the tags that Elastic Beanstalk applied to the environment when you created it, and any tags that you added. You
can add, edit, and delete custom tags. You can't edit or delete the tags that Elastic Beanstalk applied.
Environment tags are applied to every resource that Elastic Beanstalk creates to support your application.
For more information, see Tagging resources in your Elastic Beanstalk environments.
- New console
-
The Tags page shows the tags that Elastic Beanstalk applied to the environment when you created it, and any tags that you added. You
can add, edit, and delete custom tags. You can't edit or delete the tags that Elastic Beanstalk applied.
Environment tags are applied to every resource that Elastic Beanstalk creates to support your application.
For more information, see Tagging resources in your Elastic Beanstalk environments.
Configuration
- Old console
-
The Configuration overview page shows the current configuration of your environment and its resources, including Amazon EC2
instances, a load balancer, notifications, and health monitoring settings. Use the settings on this page to customize the behavior of your
environment during deployments, enable additional features, and modify the instance type and other settings that you chose during environment
creation.
For more information, see Configuring Elastic Beanstalk environments.
- New console
-
The Configuration page shows the current configuration of your environment and its resources, including Amazon EC2 instances, a
load balancer, notifications, and health monitoring settings. Use the settings on this page to customize the behavior of your environment during
deployments, enable additional features, and modify the instance type and other settings that you chose during environment creation.
For more information, see Configuring Elastic Beanstalk environments.