本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 啟用 Elastic Beanstalk 增強型運作狀態報告
<a name="health-enhanced-enable"></a>

本主題說明如何啟用增強型運作狀態報告。它為您提供使用 Elastic Beanstalk 主控台、EB CLI 和 .ebextensions 組態為環境啟用增強型運作狀態功能的程序。

使用最新[平台版本](concepts.platforms.md)建立的新環境包括支援增強型運作狀態報告的運作狀態 AWS 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.aws.amazon.com/elasticbeanstalk)，然後在**區域**清單中選取您的 AWS 區域。

1. 在導覽窗格中，選擇**環境**，然後在清單中選擇您環境的名稱。

1. 在導覽窗格中，選擇 **Configuration** (組態)。

1. 在 **Monitoring (監控)** 組態類別中，選擇 **Edit (編輯)**。

1. 於 **Health Reporting (運作狀態報告)** 下的 **System (系統)** 中，選擇 **Enhanced (增強型)**。
**注意**  
若您使用[不支援的平台或版本](health-enhanced.md)，將不會出現增強型運作狀態報告的選項。

1. 若要儲存變更，請選擇頁面底部的**儲存變更**。

當您透過第 2 版 (v2) 平台版本建立新環境時，根據預設，Elastic Beanstalk 主控台會啟用增強型運作狀態報告。您可於環境建立期間變更運作狀態報告選項，藉此停用增強型運作狀態報告。

**使用 Elastic Beanstalk 主控台，在建立環境時停用增強型運作狀態報告**

1. 開啟 [Elastic Beanstalk 主控台](https://console.aws.amazon.com/elasticbeanstalk)，然後在**區域**清單中選取您的 AWS 區域。

1. [建立應用程式](applications.md)或選取現有程式。

1. [建立環境](using-features.environments.md)。在 **Create a new environment (建立新環境)** 頁面，在選擇 **Create environment (建立環境)** 之前，選擇 **Configure more options (設定更多選項)**。

1. 在 **Monitoring (監控)** 組態類別中，選擇 **Edit (編輯)**。

1. 於 **Health Reporting (運作狀態報告)** 下的 **System (系統)** 中選擇 **Basic (基本)**。

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` 的值不是 null，且符合您的[服務角色](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}}
```

若您已建立自己的執行個體描述檔或服務角色，請將反白顯示的文字取代為這些角色的名稱。