本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将增强型运行状况报告与 Elastic Beanstalk API 结合使用
<a name="health-enhanced-api"></a>

由于 AWS Elastic Beanstalk 增强型运行状况报告具有角色和解决方案堆栈要求，因此您必须先更新在增强型运行状况报告发布之前使用的脚本和代码，然后才能使用它。为了保持向后兼容，在您使用 Elastic Beanstalk API 创建环境时默认不会启用增强型运行状况报告。

您可以通过为您的环境设置服务角色、实例配置文件和 Amazon CloudWatch 配置选项来配置增强型运行状况报告。您可以用三种方式完成此操作：在 `.ebextensions` 文件夹中设置配置选项、使用保存的配置或在 `create-environment` 调用的 `option-settings` 参数中直接配置它们。

要使用 API SDKs、或 AWS 命令行界面 (CLI) 创建支持增强运行状况的环境，您必须：
+ 创建具有适当[权限](concepts-roles.md)的服务角色和实例配置文件
+ 使用新的[平台版本](concepts.platforms.md)创建新环境
+ 设置运行状况系统类型、实例配置文件和服务角色[配置选项](command-options.md)

使用 `aws:elasticbeanstalk:healthreporting:system`、`aws:autoscaling:launchconfiguration` 和 `aws:elasticbeanstalk:environment` 命名空间中的以下配置选项配置适用于增强型运行状况报告的环境。

## 增强型运行状况配置选项
<a name="health-enhanced-api-options"></a>

**SystemType**

命名空间: `aws:elasticbeanstalk:healthreporting:system`

要启用增强型运行状况报告，请设置为 **enhanced**。

**IamInstanceProfile**

命名空间: `aws:autoscaling:launchconfiguration`

设置为配置为与 Elastic Beanstalk 一起使用的实例配置文件的名称。

**ServiceRole**

命名空间: `aws:elasticbeanstalk:environment`

设置为配置为与 Elastic Beanstalk 一起使用的服务角色的名称。

**ConfigDocument**（可选）

命名空间: `aws:elasticbeanstalk:healthreporting:system`

一个 JSON 文档，用于定义要发布到的和实例和环境指标 CloudWatch。例如：

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

**注意**  
可能需要对配置文件进行特殊的格式化，如转义引号，具体视您将它们提供给 Elastic Beanstalk 的方式而定。有关示例，请参阅 [提供自定义指标配置文件](health-enhanced-cloudwatch.md#health-enhanced-cloudwatch-configdocument)。