本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 手動檢測 AWS SDK 用戶端
<a name="scorekeep-sdkclients"></a>

**注意**  
X-Ray 開發套件/協助程式維護通知 – 在 2026 年 2 月 25 日， AWS X-Ray SDKs/協助程式將進入維護模式，其中 AWS 將限制 X-Ray 開發套件和協助程式版本，以僅解決安全問題。如需支援時間軸的詳細資訊，請參閱 [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 用戶端。 [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 用戶端會出現在追蹤映射中。