手動檢測 AWS SDK 用戶端

注意

End-of-support通知 – 在 2027 年 2 月 25 日， AWS X-Ray 將停止支援 AWS X-Ray SDKs 和協助程式。2027 年 2 月 25 日之後，您將不再收到更新或版本。如需支援時間表的詳細資訊，請參閱 X-Ray SDK 和協助程式終止支援時間表。建議您遷移至 OpenTelemetry。如需遷移至 OpenTelemetry 的詳細資訊，請參閱從 X-Ray 檢測遷移至 OpenTelemetry 檢測。

當您在建置相依性中包含 AWS SDK Instrumentor 子模組時，適用於 Java 的 X-Ray 開發套件會自動檢測所有 SDK 用戶端。 AWS

若要停用自動用戶端檢測，您可以移除 Instrumentor 子模組。這可讓您手動檢測一些特定用戶端而忽略其他用戶端，或使用不同用戶端上的不同追蹤處理常式。

為了說明檢測特定 AWS SDK 用戶端的支援，應用程式會將追蹤處理常式傳遞至 ，AmazonDynamoDBClientBuilder做為使用者、遊戲和工作階段模型中的請求處理常式。此程式碼變更會告知 SDK 使用這些用戶端來檢測對 DynamoDB 的所有呼叫。

範例 src/main/java/scorekeep/SessionModel.java – 手動 AWS SDK 用戶端檢測

import com.amazonaws.xray.AWSXRay;
import com.amazonaws.xray.handlers.TracingHandler;

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 用戶端會出現在追蹤映射中。