기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS X-Ray 디버깅 구성
AWS Elastic Beanstalk 콘솔 또는 구성 파일을 사용하여 환경의 인스턴스에서 AWS X-Ray 데몬을 실행할 수 있습니다. X-Ray는 애플리케이션이 처리하는 요청에 대한 데이터를 AWS 수집하고 이를 사용하여 애플리케이션의 문제와 최적화 기회를 식별하는 데 사용할 수 있는 서비스 맵을 구성하는 서비스입니다.
**참고**
일부 리전에서는 X-Ray를 제공하지 않습니다. 이러한 리전 중 한 곳에서 환경을 생성하면 해당 환경의 인스턴스에서 X-Ray 데몬을 실행할 수 없습니다.
각 리전에서 제공되는 AWS 서비스에 대한 자세한 내용은 [리전 테이블](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)을 참조하세요.
X-Ray는 애플리케이션 코드를 계측하는 데 사용할 수 있는 SDK와 SDK에서 X-Ray API로 디버깅 정보를 전달하는 데몬 애플리케이션을 제공합니다.
**지원하는 플랫폼**
X-Ray SDK는 다음과 같은 Elastic Beanstalk 플랫폼에서 사용할 수 있습니다.
+ **Go** - 버전 2.9.1 이상
+ **Java 8** - 버전 2.3.0 이상
+ **Java 8 with Tomcat 8** - 버전 2.4.0 이상
+ **Node.js** - 버전 3.2.0 이상
+ **Windows Server** - 모든 플랫폼 버전은 2016년 12월 18일 이후에 릴리스되었습니다.
+ **Python** - 버전 2.5.0 이상
지원되는 플랫폼에서 구성 옵션을 사용하여 환경의 인스턴스에서 X-Ray 데몬을 실행할 수 있습니다. [Elastic Beanstalk 콘솔](#environment-configuration-debugging-console)에서 또는 [구성 파일](#environment-configuration-debugging-namespace)을 사용하여 데몬을 활성화할 수 있습니다.
데이터를 X-Ray에 업로드하려면 X-Ray 데몬에 **AWSXrayWriteOnlyAccess** 관리형 정책의 IAM 권한이 필요합니다. 이러한 권한은 [Elastic Beanstalk 인스턴스 프로파일](concepts-roles-instance.md)에 포함되어 있습니다. 기본 인스턴스 프로파일을 사용하지 않는 경우 *AWS X-Ray 개발자 안내서*의 [데몬에 X-Ray로의 데이터 전송 권한 부여](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon.html#xray-daemon-permissions)를 참조하세요.
X-Ray를 사용하여 디버깅하려면 X-Ray SDK를 사용해야 합니다. 지침과 샘플 애플리케이션에 대해서는 *AWS X-Ray 개발자 안내서*의 [AWS X-Ray시작](https://docs.aws.amazon.com/xray/latest/devguide/xray-gettingstarted.html)을 참조하세요.
데몬이 포함되지 않은 플랫폼 버전을 사용하는 경우 구성 파일의 스크립트로 이를 실행할 수 있습니다. 자세한 내용은 *AWS X-Ray 개발자 안내서*의 [X-Ray 데몬을 직접 다운로드하여 실행(고급)](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon-beanstalk.html#xray-daemon-beanstalk-manual)을 참조하세요.
**Topics**
+ [디버깅 구성](#environment-configuration-debugging-console)
+ [aws:elasticbeanstalk:xray 네임스페이스](#environment-configuration-debugging-namespace)
## 디버깅 구성
Elastic Beanstalk 콘솔에서 실행 중인 환경에 X-Ray 데몬을 활성화할 수 있습니다.
**Elastic Beanstalk 콘솔에서 디버깅을 활성화하려면**
1. [Elastic Beanstalk 콘솔](https://console.aws.amazon.com/elasticbeanstalk)을 열고 **리전** 목록에서를 선택합니다 AWS 리전.
1. 탐색 창에서 **환경**을 선택한 다음 목록에서 환경의 이름을 선택합니다.
1. 탐색 창에서 **구성**을 선택합니다.
1. **업데이트, 모니터링 및 로깅** 구성 범주에서 **편집**을 선택합니다.
1. **Amazon X-Ray** 섹션에서 **활성화**(Activated)를 선택합니다.
1. 변경 사항을 저장하려면 페이지 하단에서 **적용**을 선택합니다.
환경 생성 중에 이 옵션을 활성화할 수도 있습니다. 자세한 내용은 [새 환경 생성 마법사](environments-create-wizard.md) 단원을 참조하십시오.
## aws:elasticbeanstalk:xray 네임스페이스
`XRayEnabled` 네임스페이스의 `aws:elasticbeanstalk:xray` 옵션을 사용하여 디버깅을 활성화할 수 있습니다.
애플리케이션을 배포할 때 디버깅을 자동으로 활성화하려면 다음과 같이 소스 코드에 있는 [구성 파일](ebextensions.md)의 옵션을 설정합니다.
**Example .ebextensions/debugging.config**
```
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true
```