기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS SDK 클라이언트 수동 계측
<a name="scorekeep-sdkclients"></a>

**참고**  
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)을 참조하세요.

빌드 종속성에 AWS SDK Instrumentor 하위 모듈을 포함하면 Java용 X-Ray SDK가 모든 SDK 클라이언트를 자동으로 계측합니다. [AWS](xray-sdk-java.md#xray-sdk-java-dependencies) 

Instrumentor 하위 모듈을 제거하여 자동 클라이언트 구성을 비활성화할 수 있습니다. 그러면 다른 클라이언트는 무시하고 일부 클라이언트만 수동으로 구성하거나 클라이언트마다 다른 트레이스 핸들러를 사용할 수 있습니다.

특정 AWS SDK 클라이언트 계측 지원을 설명하기 위해 애플리케이션은 추적 핸들러를 사용자, 게임 및 세션 모델의 요청 핸들러`AmazonDynamoDBClientBuilder`로에 전달합니다. 이 코드 변경은 SDK가 해당 클라이언트를 사용하여 DynamoDB에 대한 호출을 모두 계측하도록 지시합니다.

**Example [https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/SessionModel.java](https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/SessionModel.java) - 수동 AWS SDK 클라이언트 계측**  

```
import [com.amazonaws.xray.AWSXRay](https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/AWSXRay.html);
import [com.amazonaws.xray.handlers.TracingHandler](https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/handlers/TracingHandler.html);

public class SessionModel {
  private AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
        .withRegion(Constants.REGION)
        .withRequestHandlers(new TracingHandler(AWSXRay.getGlobalRecorder()))
        .build();
  private DynamoDBMapper mapper = new DynamoDBMapper(client);
```

프로젝트 종속성에서 AWS SDK Instrumentor 하위 모듈을 제거하면 수동으로 구성된 AWS SDK 클라이언트만 트레이스 맵에 나타납니다.