기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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. 탐색 창에서 **구성**을 선택합니다.

1. [**모니터링**] 구성 범주에서 [**편집**]을 선택합니다.

1. **상태 보고**에서 **시스템**에 대해 **확장**을 선택합니다.
**참고**  
[지원되지 않는 플랫폼 또는 버전](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)** 페이지에서 **추가 옵션 구성(Configure more options)**을 선택한 다음 **환경 생성(Create environment)**을 선택합니다.

1. [**모니터링**] 구성 범주에서 [**편집**]을 선택합니다.

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`의 값이 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}}
```

고유한 인스턴스 프로파일 또는 서비스 역할을 생성한 경우 강조 표시된 텍스트를 이러한 역할의 이름으로 바꾸세요.