AWS X-Ray 디버깅 구성

AWS Elastic Beanstalk 콘솔 또는 구성 파일을 사용하여 환경의 인스턴스에서 AWS X-Ray 데몬을 실행할 수 있습니다. X-Ray는 애플리케이션이 처리하는 요청에 대한 정보를 수집하고 이를 사용하여 애플리케이션 관련 문제와 최적화 기회를 찾는 데 사용할 수 있는 서비스 맵을 구성하는 AWS 서비스입니다.

참고

일부 리전에서는 X-Ray를 제공하지 않습니다. 이러한 리전 중 한 곳에서 환경을 생성하면 해당 환경의 인스턴스에서 X-Ray 데몬을 실행할 수 없습니다.

각 리전에서 제공되는 AWS 서비스에 대한 자세한 내용은 리전 표를 참조하세요.

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 콘솔에서 또는 구성 파일을 사용하여 데몬을 활성화할 수 있습니다.

데이터를 X-Ray에 업로드하려면 X-Ray 데몬에 AWSXrayWriteOnlyAccess 관리형 정책의 IAM 권한이 필요합니다. 이러한 권한은 Elastic Beanstalk 인스턴스 프로파일에 포함되어 있습니다. 기본 인스턴스 프로파일을 사용하지 않는 경우 AWS X-Ray 개발자 안내서의 데몬에 X-Ray로의 데이터 전송 권한 부여를 참조하세요.

X-Ray를 사용하여 디버깅하려면 X-Ray SDK를 사용해야 합니다. 지침과 샘플 애플리케이션에 대해서는 AWS X-Ray 개발자 안내서의 AWS X-Ray 시작을 참조하세요.

데몬이 포함되지 않은 플랫폼 버전을 사용하는 경우 구성 파일의 스크립트로 이를 실행할 수 있습니다. 자세한 내용은 AWS X-Ray 개발자 안내서의 X-Ray 데몬을 직접 다운로드하여 실행(고급)을 참조하세요.

디버깅 구성

Elastic Beanstalk 콘솔에서 실행 중인 환경에 X-Ray 데몬을 활성화할 수 있습니다.

Elastic Beanstalk 콘솔에서 디버깅을 활성화하려면

1. Elastic Beanstalk 콘솔을 연 다음 리전(Regions) 목록에서 해당 AWS 리전을 선택합니다.

2. 탐색 창에서 환경을 선택한 다음 목록에서 환경 이름을 선택합니다.

   참고

   여러개의 환경을 보유한 경우 검색 창을 통해 환경 목록을 필터링합니다.

3. 탐색 창에서 구성을 선택합니다.

4. 업데이트, 모니터링 및 로깅 구성 범주에서 편집을 선택합니다.

5. Amazon X-Ray 섹션에서 활성화(Activated)를 선택합니다.

6. 변경 사항을 저장하려면 페이지 하단에서 적용을 선택합니다.

환경 생성 중에 이 옵션을 활성화할 수도 있습니다. 자세한 내용은 새 환경 생성 마법사 섹션을 참조하세요.

aws:elasticbeanstalk:xray 네임스페이스

XRayEnabled 네임스페이스의 aws:elasticbeanstalk:xray 옵션을 사용하여 디버깅을 활성화할 수 있습니다.

애플리케이션을 배포할 때 디버깅을 자동으로 활성화하려면 다음과 같이 소스 코드에 있는 구성 파일의 옵션을 설정합니다.

예 .ebextensions/debugging.config

option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true