Using enhanced health reporting with the Elastic Beanstalk API - Amazon Elastic Beanstalk
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).

Using enhanced health reporting with the Elastic Beanstalk API

Because Amazon Elastic Beanstalk enhanced health reporting has role and solution stack requirements, you must update scripts and code that you used prior to the release of enhanced health reporting before you can use it. To maintain backward compatibility, enhanced health reporting is not enabled by default when you create an environment using the Elastic Beanstalk API.

You configure enhanced health reporting by setting the service role, the instance profile, and Amazon CloudWatch configuration options for your environment. You can do this in three ways: by setting the configuration options in the .ebextensions folder, with saved configurations, or by configuring them directly in the create-environment call's option-settings parameter.

To use the API, SDKs, or Amazon command line interface (CLI) to create an environment that supports enhanced health, you must:

Use the following configuration options in the aws:elasticbeanstalk:healthreporting:system, aws:autoscaling:launchconfiguration, and aws:elasticbeanstalk:environment namespaces to configure your environment for enhanced health reporting.

Enhanced health configuration options


Namespace: aws:elasticbeanstalk:healthreporting:system

To enable enhanced health reporting, set to enhanced.


Namespace: aws:autoscaling:launchconfiguration

Set to the name of an instance profile configured for use with Elastic Beanstalk.


Namespace: aws:elasticbeanstalk:environment

Set to the name of a service role configured for use with Elastic Beanstalk.

ConfigDocument (optional)

Namespace: aws:elasticbeanstalk:healthreporting:system

A JSON document that defines the and instance and environment metrics to publish to CloudWatch. For example:

{ "CloudWatchMetrics": { "Environment": { "ApplicationLatencyP99.9":60, "InstancesSevere":60 } "Instance": { "ApplicationLatencyP85":60, "CPUUser": 60 } } "Version":1 }

Config documents may require special formatting, such as escaping quotes, depending on how you provide them to Elastic Beanstalk. See Providing custom metric config documents for examples.