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

# 启用 Elastic Beanstalk 增强型运行状况报告
<a name="health-enhanced-enable"></a>

本主题介绍如何启用增强型运行状况报告。它为您提供了使用 Elastic Beanstalk 控制台、EB CLI 和 .ebextensions 配置为您的环境启用增强型运行状况功能的过程。

使用最新[平台版本](concepts.platforms.md)创建的新环境包括支持增强型 Amazon Elastic Beanstalk [运行状况报告的运行状况代理](health-enhanced.md#health-enhanced-agent)。如果您在 Elastic Beanstalk 控制台中或使用 EB CLI 创建环境，则默认启用增强型运行状况。您也可以使用[配置文件](ebextensions.md)在应用程序的源代码中设置运行状况报告首选项。

增强型运行状况报告要求[实例配置文件](concepts-roles-instance.md)和有标准权限集的[服务角色](concepts-roles-service.md)。在 Elastic Beanstalk 控制台中创建环境时，Elastic Beanstalk 会自动创建所需的角色。有关创建您的第一个环境的说明，请参阅[了解如何开始使用 Elastic Beanstalk](GettingStarted.md)。

**Topics**
+ [使用 Elastic Beanstalk 控制台启用增强型运行状况报告](#health-enhanced-enable-console)
+ [使用 EB CLI 启用增强型运行状况报告](#health-enhanced-enable-ebcli)
+ [使用配置文件启用增强型运行状况报告](#health-enhanced-enable-config)

## 使用 Elastic Beanstalk 控制台启用增强型运行状况报告
<a name="health-enhanced-enable-console"></a>

**使用 Elastic Beanstalk 控制台在正在运行的环境中启用增强型运行状况报告**

1. 打开 [Elastic Beanstalk](https://console.amazonaws.cn/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 Amazon Web Services 区域

1. 在导航窗格中，选择 **Environments**（环境），然后从列表中选择环境的名称。

1. 在导航窗格中，选择 **Configuration**（配置）。

1. 在 **Monitoring (监控)** 配置类别中，选择 **Edit (编辑)**。

1. 在**运行状况报告**下，为**系统**选择**增强型**。
**注意**  
如果您使用的是[不受支持的平台或版本](health-enhanced.md)，则不会显示用于增强型运行状况报告的选项。

1. 要保存更改，请选择页面底部的 **Apply**（应用）。

在使用版本 2 (v2) 平台版本创建新环境时，Elastic Beanstalk 控制台默认使用增强型运行状况报告。您可以通过在环境创建期间更改运行状况报告选项来禁用增强型运行状况报告。

**在使用 Elastic Beanstalk 控制台创建环境时禁用增强型运行状况报告**

1. 打开 [Elastic Beanstalk](https://console.amazonaws.cn/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 Amazon Web Services 区域

1. [创建一个应用程序](applications.md)或选择现有应用程序。

1. [创建一个环境](using-features.environments.md)。在**创建新环境**页面上，在选择**创建环境**之前，选择**配置更多选项**。

1. 在 **Monitoring (监控)** 配置类别中，选择 **Edit (编辑)**。

1. 在**运行状况报告**下，为**系统**选择**基本**。

1. 选择**保存**。

## 使用 EB CLI 启用增强型运行状况报告
<a name="health-enhanced-enable-ebcli"></a>

在使用 **eb create** 命令创建新环境时，EB CLI 默认启用增强型运行状况报告并应用默认实例配置文件和服务角色。

您可以使用 `--service-role` 选项通过名称指定不同的服务角色。

如果您有一个在 v2 平台版本上使用基本运行状况报告运行的环境且希望将其切换到增强型运行状况，请按以下步骤操作。

**使用 [EB CLI](eb-cli3.md) 在正在运行的环境上启用增强型运行状况**

1. 使用 **eb config** 命令在默认文本编辑器中打开配置文件。

   ```
   ~/project$ eb config
   ```

1. 在设置部分找到 `aws:elasticbeanstalk:environment` 命名空间。确保 `ServiceRole` 的值不为空且与您的[服务角色](concepts-roles-service.md)的名称匹配。

   ```
     aws:elasticbeanstalk:environment:
       EnvironmentType: LoadBalanced
       ServiceRole: {{aws-elasticbeanstalk-service-role}}
   ```

1. 在 `aws:elasticbeanstalk:healthreporting:system:` 命名空间下，将 `SystemType` 的值更改为 **enhanced**。

   ```
     aws:elasticbeanstalk:healthreporting:system:
       SystemType: enhanced
   ```

1. 保存配置文件，关闭文本编辑器。

1. EB CLI 将启动环境更新以应用配置更改。等待操作完成或按 **Ctrl\+C** 以安全退出。

   ```
   ~/project$ eb config
   Printing Status:
   INFO: Environment update is starting.
   INFO: Health reporting type changed to ENHANCED.
   INFO: Updating environment no-role-test's configuration settings.
   ```

## 使用配置文件启用增强型运行状况报告
<a name="health-enhanced-enable-config"></a>

您可以通过在源包中包含[配置文件](ebextensions.md)来启用增强型运行状况报告。下面示例的配置文件启用增强型运行状况报告并为环境分配默认服务和实例配置文件：

**Example .ebextensions/enhanced-health.config**  

```
option_settings:
  aws:elasticbeanstalk:healthreporting:system:
    SystemType: enhanced
  aws:autoscaling:launchconfiguration:
    IamInstanceProfile: {{aws-elasticbeanstalk-ec2-role}}
  aws:elasticbeanstalk:environment:
    ServiceRole: {{aws-elasticbeanstalk-service-role}}
```

如果您创建了自己的实例配置文件或服务角色，请将突出显示的文本替换为这些角色的名称。