기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # AWS X-Ray 샘플 애플리케이션 **참고** X-Ray SDK/데몬 유지 관리 공지 - 2026년 2월 25일에 AWS X-Ray SDKs/데몬은 유지 관리 모드로 전환되며, 여기서 AWS 는 보안 문제만 해결하도록 X-Ray SDK 및 데몬 릴리스를 제한합니다. 지원 일정에 대한 자세한 내용은 [X-Ray SDK 및 데몬 지원 타임라인](xray-sdk-daemon-timeline.md) 섹션을 참조하세요. OpenTelemetry로 마이그레이션하는 것이 좋습니다. OpenTelemetry로 마이그레이션하는 방법에 대한 자세한 내용은 [X-Ray 계측에서 OpenTelemetry 계측으로 마이그레이션](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html)을 참조하세요. GitHub에서 사용할 수 있는 AWS X-Ray [eb-java-scorekeep](https://github.com/awslabs/eb-java-scorekeep/tree/xray) 샘플 앱은 AWS X-Ray SDK를 사용하여 수신 HTTP 호출, DynamoDB SDK 클라이언트 및 HTTP 클라이언트를 계측하는 방법을 보여줍니다. 샘플 앱은 CloudFormation 를 사용하여 DynamoDB 테이블을 생성하고, 인스턴스에서 Java 코드를 컴파일하고, 추가 구성 없이 X-Ray 데몬을 실행합니다. AWS Management Console 또는 [를 사용하여 계측된 샘플 애플리케이션의 설치 및 사용을 시작하려면 Scorekeep 자습](scorekeep-tutorial.md)서를 참조하세요 AWS CLI. ![\[Scorekeep은 AWS X-Ray SDK를 사용하여 수신 HTTP 호출, DynamoDB SDK 클라이언트 및 HTTP 클라이언트를 계측합니다.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/scorekeep-flow.png) 여기에는 프런트엔드 웹 앱, 이 앱이 직접 호출하는 API, 이 앱이 데이터를 저장하는 데 사용하는 DynamoDB 테이블이 포함되어 있습니다. [필터](xray-sdk-java-filters.md), [플러그인](xray-sdk-java-configuration.md) 및 [계측된 AWS SDK 클라이언트](xray-sdk-java-awssdkclients.md)를 사용한 기본 계측은 프로젝트의 `xray-gettingstarted`브랜치에 표시됩니다. 이는 [시작하기 자습서](scorekeep-tutorial.md)에서 배포하는 분기입니다. 이 분기에는 기본 사항만 포함되어 있으므로 `master` 분기와의 차이점을 확인하여 기본 사항을 신속하게 이해할 수 있습니다. ![\[Service map showing client interaction with Scorekeep container and related AWS 서비스.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/scorekeep-gettingstarted-servicemap-before-ECS.png) 샘플 애플리케이션은 다음 파일에서 기본 구성을 보여 줍니다. + **HTTP 요청 필터** – [https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/WebConfig.java](https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/WebConfig.java) + **AWS SDK 클라이언트 계측** - [https://github.com/awslabs/eb-java-scorekeep/tree/xray/build.gradle](https://github.com/awslabs/eb-java-scorekeep/tree/xray/build.gradle) 애플리케이션의 `xray` 분기는 [HTTPClient](xray-sdk-java-httpclients.md), [주석](xray-sdk-java-segment.md), [SQL 쿼리](xray-sdk-java-sqlclients.md), [사용자 지정 하위 세그먼트](xray-sdk-java-subsegments.md), 구성된 [AWS Lambda](xray-services-lambda.md) 함수 및 [구성된 초기화 코드 및 스크립트](scorekeep-startup.md) 사용을 포함합니다. 브라우저에서 사용자 로그인 및 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에 저장합니다. **Topics** + [Scorekeep 샘플 애플리케이션 시작하기](scorekeep-tutorial.md) + [AWS SDK 클라이언트 수동 계측](scorekeep-sdkclients.md) + [추가 하위 세그먼트 생성](scorekeep-subsegments.md) + [주석, 메타데이터 및 사용자 ID 기록](scorekeep-annotations.md) + [발신 HTTP 호출 구성](scorekeep-httpclient.md) + [PostgreSQL 데이터베이스에 대한 호출 구성](scorekeep-postgresql.md) + [AWS Lambda 함수 계측](scorekeep-lambda.md) + [시작 코드 구성](scorekeep-startup.md) + [스크립트 구성](scorekeep-scripts.md) + [웹 앱 클라이언트 구성](scorekeep-client.md) + [작업자 스레드에서 구성된 클라이언트 사용](scorekeep-workerthreads.md)