本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # AWS X-Ray 範例應用程式 **注意** 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 X-Ray [eb-java-scorekeep](https://github.com/awslabs/eb-java-scorekeep/tree/xray) 範例應用程式可在 GitHub 上取得，顯示使用 AWS X-Ray 開發套件來檢測傳入 HTTP 呼叫、DynamoDB SDK 用戶端和 HTTP 用戶端。範例應用程式使用 CloudFormation 來建立 DynamoDB 資料表、在執行個體上編譯 Java 程式碼，以及執行 X-Ray 協助程式，無需任何其他組態。 請參閱 [Scorekeep 教學](scorekeep-tutorial.md)課程，以使用 AWS 管理主控台 或 開始安裝和使用經檢測的範例應用程式 AWS CLI。 ![\[Scorekeep 使用 AWS X-Ray 開發套件來檢測傳入 HTTP 呼叫、DynamoDB SDK 用戶端和 HTTP 用戶端\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/scorekeep-flow.png) 範例包含前端 Web 應用程式、它呼叫的 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` 分支進行 diff，來快速了解基本項目。 ![\[Service map showing client interaction with Scorekeep container and related AWS 服務.\]](http://docs.aws.amazon.com/zh_tw/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)。 為了支援使用者登入並在瀏覽器 適用於 JavaScript 的 AWS SDK 中使用 ，`xray-cognito`分支會新增 Amazon Cognito 以支援使用者身分驗證和授權。透過從 Amazon Cognito 擷取的登入資料，Web 應用程式也會將追蹤資料傳送至 X-Ray，以從用戶端的觀點記錄請求資訊。瀏覽器用戶端會在追蹤地圖上顯示為自己的節點，並記錄其他資訊，包括使用者正在檢視的頁面 URL，以及使用者的 ID。 最後，`xray-worker`分支會新增經過檢測的 Python Lambda 函數，可獨立執行，處理來自 Amazon SQS 佇列的項目。Scorekeep 會在每次遊戲結束時新增項目到佇列中。CloudWatch Events 觸發的 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) + [檢測 Web 應用程式用戶端](scorekeep-client.md) + [在工作者執行緒中使用受檢測用戶端](scorekeep-workerthreads.md)