

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

# AI 기반 환경 분석
<a name="health-ai-analysis"></a>

AWS Elastic Beanstalk의 AI 기반 분석은 근본 원인을 식별하고 환경 상태 문제에 대한 솔루션을 권장합니다. 환경에 문제가 발생하면 `analyze` 정보 유형과 함께 `RequestEnvironmentInfo` 및 `RetrieveEnvironmentInfo` API 작업을 사용하여 AI 분석을 요청하여 AI 생성 인사이트와 권장 솔루션을 얻을 수 있습니다.

**참고**  
AI 분석은 2026년 2월 16일 또는 그 이후에 릴리스된 지원되는 Amazon Linux 2 및 AL2023 플랫폼 버전에서만 사용할 수 있습니다.

## 작동 방식
<a name="health-ai-analysis-how-it-works"></a>

AI 분석을 요청하면 Elastic Beanstalk는 환경의 인스턴스에서 최근 이벤트, 인스턴스 상태 및 로그(최대 170,000개의 데이터 [토큰](https://docs.aws.amazon.com/bedrock/latest/userguide/key-definitions.html))를 수집하는 스크립트를 실행합니다. 그런 다음이 데이터를 계정의 Amazon Bedrock으로 전송하고 인사이트와 권장 다음 단계를 반환합니다.

## 사전 조건
<a name="health-ai-analysis-prereqs"></a>

AI 분석을 사용하기 전에 환경이 다음 요구 사항을 충족하는지 확인합니다.
+ [지원되는 플랫폼 버전을](#health-ai-analysis-supported-platforms) 실행하는 환경
+ 필요한 권한이 있는 [인스턴스 프로파일](iam-instanceprofile.md)([필수 권한](#health-ai-analysis-permissions)아래 참조)
+ **Anthropic 사용 사례 세부 정보** - AI 분석은 Amazon Bedrock을 통해 Anthropic Claude 모델을 사용합니다. Anthropic에서는 모델을 호출하기 전에 일회용 사용 사례 세부 정보 양식을 제출해야 합니다. 이 양식을 제출하려면 [Amazon Bedrock 콘솔](https://console.aws.amazon.com/bedrock/)의 모델 카탈로그에서 Anthropic 모델을 선택하거나 [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html) API를 호출합니다. 이 작업은 AWS 계정당 한 번만 수행하면 됩니다. AWS Organizations 관리 계정에서 양식을 제출하면 조직의 모든 멤버 계정이 자동으로 포함됩니다. 자세한 내용은 [Amazon Bedrock 파운데이션 모델 액세스를](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) 참조하세요.
+ **GovCloud 리전** - AWS GovCloud(미국) 리전을 사용하는 경우 AI 분석을 사용하기 전에 Amazon Bedrock에서 최신 Anthropic Claude Sonnet 및/또는 Opus 모델에 대한 액세스를 활성화해야 합니다. GovCloud 리전에서 모델 액세스를 활성화[하는 방법에 대한 지침은 Amazon Bedrock 파운데이션 모델에 대한 액세스 관리를](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html#model-access-govcloud) 참조하세요. 사용 가능한 최신 Anthropic Claude Sonnet 및/또는 Opus 모델에 대한 자세한 내용은 [추론 프로파일에 대해 지원되는 리전 및 모델을 참조하세요](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html).

## 필수 권한
<a name="health-ai-analysis-permissions"></a>

AI 분석을 사용하려면 환경의 Amazon EC2 인스턴스 프로파일에 Amazon Bedrock을 호출할 권한이 있어야 합니다. 인스턴스 프로파일에 다음 권한을 추가합니다.
+ `bedrock:InvokeModel`
+ `bedrock:ListFoundationModels`
+ `elasticbeanstalk:DescribeEvents`
+ `elasticbeanstalk:DescribeEnvironmentHealth`

인스턴스 프로파일 구성에 대한 자세한 내용은 섹션을 참조하세요[Elastic Beanstalk 인스턴스 프로파일 관리](iam-instanceprofile.md).

## 콘솔에서 AI 분석 사용
<a name="health-ai-analysis-console"></a>

**환경 개요에서**  
환경의 상태가 **경고**, **성능 저하** 또는 **심각**이면 환경 개요 섹션에 **AI 분석** 버튼이 나타납니다. 환경에 대한 AI 분석을 시작하려면이 버튼을 클릭합니다.

**로그 페이지에서**  
탐색 창의 **로그** 페이지에서 AI 분석에 액세스할 수도 있습니다. **AI 분석** 버튼을 클릭하여 환경의 현재 상태에 대한 AI 기반 분석을 요청합니다.

## 에서 AI 분석 사용 AWS CLI
<a name="health-ai-analysis-api"></a>

를 통해 Elastic Beanstalk API AWS CLI 를 사용하여 프로그래밍 방식으로 AI 분석을 요청하고 검색할 수 있습니다.

**AI 분석 요청**  
`InfoType` 파라미터가 로 설정된 상태에서 [https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RequestEnvironmentInfo.html) 작업을 사용합니다`analyze`.

**Example AWS CLI - AI 분석 요청**  

```
aws elasticbeanstalk request-environment-info \
    --environment-name my-env \
    --info-type analyze \
    --region us-east-1
```

**AI 분석 검색**  
`InfoType` 파라미터가 로 설정된 [https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_RetrieveEnvironmentInfo.html) 작업을 사용하여 분석 결과를 `analyze` 검색합니다.

**Example AWS CLI - AI 분석 검색**  

```
aws elasticbeanstalk retrieve-environment-info \
    --environment-name my-env \
    --info-type analyze \
    --region us-east-1
```

응답에는 식별된 문제에 대한 권장 솔루션과 함께 환경의 현재 상태에 대한 AI 생성 분석이 포함됩니다.

## EB CLI에서 AI 분석 사용
<a name="health-ai-analysis-ebcli"></a>

EB CLI를 사용하는 경우 **eb logs** 명령의 `--analyze` (`-ai`) 옵션을 사용하여 AI 분석을 요청할 수 있습니다. 명령은 분석을 요청하고 완료될 때까지 기다린 다음 결과를 표시합니다.

**Example EB CLI - AI 분석 요청**  

```
$ eb logs --analyze
```

`--analyze` 옵션은 `--instance`, `--all`, `--zip`또는와 호환되지 않습니다`--log-group`. 전체 명령 참조는 섹션을 참조하세요[**eb logs**](eb3-logs.md).

**참고**  
`--analyze` 옵션에는 EB CLI 버전 3.27 이상이 필요합니다.

## 중요 고려 사항
<a name="health-ai-analysis-considerations"></a>
+ **요금** - AI 분석은 Amazon Bedrock을 사용하여 환경 데이터를 처리하고 모델 호출에는 표준 Amazon Bedrock 요금이 적용됩니다. 요금 세부 정보는 [Amazon Bedrock 요금](https://aws.amazon.com/bedrock/pricing/)을 참조하세요.
+ **플랫폼 요구 사항** - AI 분석은 2026년 2월 16일 또는 그 이후에 릴리스된 Amazon Linux 2 및 AL2023 기반 플랫폼 버전에서만 사용할 수 있습니다. 이 기능을 사용하려면 환경을 지원되는 플랫폼 버전으로 업데이트합니다. 자세한 내용은 [Elastic Beanstalk 환경의 플랫폼 버전 업데이트](using-features.platform.upgrade.md) 단원을 참조하십시오.
+ **권한** - AI 분석을 사용하기 전에 인스턴스 프로파일에 필요한 Amazon Bedrock 권한(`bedrock:InvokeModel` 및 `bedrock:ListFoundationModels`)과 Elastic Beanstalk 권한(`elasticbeanstalk:DescribeEvents` 및 )이 있는지 확인합니다`elasticbeanstalk:DescribeEnvironmentHealth`.
+ **데이터 개인 정보 보호** - 분석은 처리를 위해 환경 이벤트와 로그를 계정의 Amazon Bedrock으로 전송합니다. Amazon Bedrock이 데이터를 처리하는 방법에 대한 자세한 내용은 [Amazon Bedrock 보안 및 규정 준수를](https://aws.amazon.com/bedrock/security-compliance/) 참조하세요.
+ **서비스 할당량 **- AI 분석은 분당 요청 수와 분당 토큰 수에 대한 기본 할당량이 있는 Amazon Bedrock의 Anthropic Claude 모델을 사용합니다. 제한 오류가 발생하면 할당량 증가를 요청할 수 있습니다. 자세한 내용은 [할당량 증가 요청](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)을 참조하세요.

## 지원되는 플랫폼 버전
<a name="health-ai-analysis-supported-platforms"></a>

AI 분석은 2026년 2월 16일 또는 그 이후에 릴리스된 Amazon Linux 2 및 AL2023 기반 플랫폼 버전에서 지원됩니다. [RELEASE_NOTES_URL](RELEASE_NOTES_URL) 플랫폼 버전을 확인하려면 [Elastic Beanstalk 릴리스 정보를](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/welcome.html) 참조하세요.