기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AI 기반 환경 분석
AWS Elastic Beanstalk의 AI 기반 분석은 근본 원인을 식별하고 환경 상태 문제에 대한 솔루션을 권장합니다. 환경에 문제가 발생하면 `analyze` 정보 유형과 함께 `RequestEnvironmentInfo` 및 `RetrieveEnvironmentInfo` API 작업을 사용하여 AI 분석을 요청하여 AI 생성 인사이트와 권장 솔루션을 얻을 수 있습니다.
**참고**
AI 분석은 2026년 2월 26일 또는 그 이후에 릴리스된 지원되는 Amazon Linux 2 및 AL2023 플랫폼 버전에서 사용할 수 있습니다. Windows Server 플랫폼의 경우 2026년 4월 22일 이후에 릴리스된 플랫폼 버전에서 AI 분석을 사용할 수 있습니다.
## 작동 방식
AI 분석을 요청하면 Elastic Beanstalk는 환경의 인스턴스에서 최근 이벤트, 인스턴스 상태 및 로그(최대 170,000개의 데이터 [토큰](https://docs.aws.amazon.com/bedrock/latest/userguide/key-definitions.html))를 수집하는 스크립트를 실행합니다. 그런 다음이 데이터를 계정의 Amazon Bedrock으로 전송하고 인사이트와 권장 다음 단계를 반환합니다.
## 사전 조건
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 모델을 선택하거나 [`PutUseCaseForModelAccess`](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) 참조하세요.
+ 사용 사례 세부 정보 양식을 제출한 후에도 계정에서 Anthropic Claude 모델을 처음 호출하려면 자동 모델 구독을 완료하기 위한 AWS Marketplace 권한이 필요합니다. 인스턴스 프로파일에 이러한 권한이 없는 경우 AI 분석이 실패하고 다음 오류가 발생합니다.
`AccessDeniedException: Model access is denied due to IAM user or service role is not authorized to perform the required AWS Marketplace actions (aws-marketplace:ViewSubscriptions, aws-marketplace:Subscribe) to enable access to this model.`
이 문제를 해결하려면 인스턴스 프로파일에 `aws-marketplace:Subscribe``aws-marketplace:Unsubscribe`, 및 `aws-marketplace:ViewSubscriptions` 권한을 추가합니다. 이러한 권한은 계정의 첫 번째 간접 호출에만 필요합니다. 모델이 활성화되면 모델을 제거할 수 있습니다. 자세한 내용은 [Amazon Bedrock 파운데이션 모델에 대한 액세스를 요청할 수 있는 IAM 권한 부여를](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html#model-access-permissions) 참조하세요.
+ **GovCloud 리전** - AWS GovCloud(미국) 리전을 사용하는 경우 AI 분석은 Anthropic Claude 대신 NVIDIA Nemotron 모델을 사용합니다. AI 분석을 사용하기 전에 Amazon Bedrock에서 NVIDIA Nemotron 3 Super 120B 모델에 대한 액세스를 요청해야 합니다. 액세스를 요청하려면 GovCloud 콘솔에서 [Amazon Bedrock 모델 액세스](https://console.amazonaws-us-gov.com/bedrock/home#/modelaccess) 페이지를 열고 NVIDIA Nemotron 3 Super 120B에 대한 액세스를 요청합니다. GovCloud 리전에는 Anthropic 사용 사례 세부 정보 양식과 AWS Marketplace 권한이 필요하지 않습니다. GovCloud에서 모델 액세스를 활성화하는 방법에 대한 자세한 내용은 [Access Amazon Bedrock foundation models in AWS GovCloud (US)](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html#model-access-govcloud)를 참조하세요.
## 필수 권한
AI 분석을 사용하려면 환경의 Amazon EC2 인스턴스 프로파일에 Amazon Bedrock을 호출할 권한이 있어야 합니다. 인스턴스 프로파일에 다음 권한을 추가합니다.
+ `bedrock:InvokeModel`
+ `bedrock:ListFoundationModels`
+ `elasticbeanstalk:DescribeEvents`
+ `elasticbeanstalk:DescribeEnvironmentHealth`
인스턴스 프로파일 구성에 대한 자세한 내용은 섹션을 참조하세요[Elastic Beanstalk 인스턴스 프로파일 관리](iam-instanceprofile.md).
**참고**
상용 리전에서 계정에서 Anthropic Claude 모델을 처음 호출하는 경우 AWS Marketplace 권한(,`aws-marketplace:Subscribe` `aws-marketplace:Unsubscribe`및 `aws-marketplace:ViewSubscriptions`)도 필요합니다. GovCloud 리전에서는 이러한 권한이 필요하지 않습니다. 세부 정보는 [사전 조건](#health-ai-analysis-prereqs) 섹션을 참조하세요.
## 콘솔에서 AI 분석 사용
**환경 개요에서**
환경의 상태가 **경고**, **성능 저하** 또는 **심각**이면 환경 개요 섹션에 **AI 분석** 버튼이 나타납니다. 환경에 대한 AI 분석을 시작하려면이 버튼을 클릭합니다.
**로그 페이지에서**
탐색 창의 **로그** 페이지에서 AI 분석에 액세스할 수도 있습니다. **AI 분석** 버튼을 클릭하여 환경의 현재 상태에 대한 AI 기반 분석을 요청합니다.
## 에서 AI 분석 사용 AWS CLI
를 통해 Elastic Beanstalk API AWS CLI 를 사용하여 프로그래밍 방식으로 AI 분석을 요청하고 검색할 수 있습니다.
**AI 분석 요청**
`InfoType` 파라미터가 로 설정된 상태에서 [`RequestEnvironmentInfo`](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` 파라미터를 로 설정한 상태에서 [`RetrieveEnvironmentInfo`](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 분석 사용
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 이상이 필요합니다.
## 중요 고려 사항
+ **요금** - AI 분석은 Amazon Bedrock을 사용하여 환경 데이터를 처리하고 모델 호출에는 표준 Amazon Bedrock 요금이 적용됩니다. 요금 세부 정보는 [Amazon Bedrock 요금](https://aws.amazon.com/bedrock/pricing/)을 참조하세요.
+ **플랫폼 요구 사항** - AI 분석은 2026년 2월 26일 또는 그 이후에 릴리스된 Amazon Linux 2 및 AL2023 기반 플랫폼 버전에서 사용할 수 있습니다. Windows Server 플랫폼의 경우 2026년 4월 22일 이후에 릴리스된 플랫폼 버전에서 AI 분석을 사용할 수 있습니다. 이 기능을 사용하려면 환경을 지원되는 플랫폼 버전으로 업데이트합니다. 자세한 내용은 [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 모델이 사용됩니다. GovCloud 리전에서는 NVIDIA Nemotron 모델이 사용됩니다. 제한 오류가 발생하면 할당량 증가를 요청할 수 있습니다. 자세한 내용은 [할당량 증가 요청](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)을 참조하세요.
## 지원되는 플랫폼 버전
AI 분석은 2026년 2월 26일 또는 그 이후에 릴리스된 Amazon Linux 2 및 AL2023 기반 플랫폼 버전에서 지원됩니다. [https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-02-26-al2023.html](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-02-26-al2023.html) Windows Server 플랫폼의 경우 AI 분석은 2[026년 4월 22](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2026-04-22-windows.html)일 또는 그 이후에 릴리스된 플랫폼 버전에서 지원됩니다. 플랫폼 버전을 확인하려면 [Elastic Beanstalk 릴리스 정보를](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/welcome.html) 참조하세요.