AWS X-Ray 샘플 애플리케이션

GitHub에서 사용할 수 있는 AWS X-Ray eb-java-scorekeep 샘플 앱은 AWS X-Ray SDK를 사용하여 수신 HTTP 호출, DynamoDB SDK 클라이언트 및 HTTP 클라이언트를 계측하는 방법을 보여줍니다. 샘플 앱은 AWS CloudFormation 를 사용하여 DynamoDB 테이블을 생성하고, 인스턴스에서 Java 코드를 컴파일하고, 추가 구성 없이 X-Ray 데몬을 실행합니다.

AWS Management Console 또는 를 사용하여 계측된 샘플 애플리케이션의 설치 및 사용을 시작하려면 Scorekeep 자습서를 참조하세요 AWS CLI.

여기에는 프런트엔드 웹 앱, 이 앱이 직접 호출하는 API, 이 앱이 데이터를 저장하는 데 사용하는 DynamoDB 테이블이 포함되어 있습니다. 필터, 플러그인 및 계측된 AWS SDK 클라이언트를 사용한 기본 계측은 프로젝트의 xray-gettingstarted브랜치에 표시됩니다. 이는 시작하기 자습서에서 배포하는 분기입니다. 이 분기에는 기본 사항만 포함되어 있으므로 master 분기와의 차이점을 확인하여 기본 사항을 신속하게 이해할 수 있습니다.

샘플 애플리케이션은 다음 파일에서 기본 구성을 보여 줍니다.

애플리케이션의 xray 분기는 HTTPClient, 주석, SQL 쿼리, 사용자 지정 하위 세그먼트, 구성된 AWS Lambda 함수 및 구성된 초기화 코드 및 스크립트 사용을 포함합니다.

브라우저에서 사용자 로그인 및 AWS SDK for JavaScript 사용을 지원하기 위해 xray-cognito브랜치는 사용자 인증 및 권한 부여를 지원하기 위해 Amazon Cognito를 추가합니다. Amazon Cognito에서 가져온 보안 인증 정보를 사용하여 웹 앱은 트레이스 데이터를 X-Ray에 보내 클라이언트 관점에서의 요청 정보를 레코딩합니다. 브라우저 클라이언트는 트레이스 맵에 자체 노드로 표시되며, 사용자가 보고 있는 페이지의 URL 및 사용자의 ID를 포함한 추가 정보를 기록합니다.

마지막으로 xray-worker분기는 Amazon SQS 대기열에서 처리 중인 항목을 독립적으로 실행하는 계기화된 Python Lambda 함수를 추가합니다. Scorekeep는 게임이 끝날 때마다 대기열에 항목을 추가합니다. Cloudwatch 이벤트에 의해 트리거되는 Lambda 작업자는 몇 분 간격으로 대기열에서 항목을 가져온 후 처리하여 분석을 위해 게임 레코드를 Amazon S3에 저장합니다.