本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # AWS X-Ray 示例应用程序 **注意** X-Ray SDK/Daemon 维护通知 — 2026 年 2 月 25 日， AWS X-Ray SDKs/Daemon 将进入维护模式，在该模式下，X-Ray SDK 和 Daemon 的发布 AWS 将仅限于解决安全问题。有关支持时间表的更多信息，请参阅 [X-Ray SDK 和 Daemon Support 时间表](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 守护程序，无需任何其他配置。 请参阅 [Scorekeeep 教程](scorekeep-tutorial.md)，使用或开始安装和使用带检测功能的 AWS 管理控制台 示例应用程序。 AWS CLI ![\[Scorekeep 使用 AWS X-Ray SDK 来检测传入的 HTTP 调用、DynamoDB SDK 客户端和 HTTP 客户端\]](http://docs.aws.amazon.com/zh_cn/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` 分支比较差异，以快速理解基本分析。 ![\[Service map showing client interaction with Scorekeep container and related AWS 服务.\]](http://docs.aws.amazon.com/zh_cn/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` 分支将添加独立运行的检测过的 Lambda 函数，并处理来自 Amazon SQS 队列的项目。每当游戏结束时，Scorekeep 就会向队列添加一个项目。由 CloudWatch 事件触发的 Lambda 工作程序每隔几分钟从队列中提取项目，然后对其进行处理，以便将游戏记录存储在 Amazon S3 中以供分析。 **Topics** + [Scorekeep 示例应用程序入门](scorekeep-tutorial.md) + [手动检测 S AWS DK 客户端](scorekeep-sdkclients.md) + [创建附加子分段](scorekeep-subsegments.md) + [记录注释、元数据和用户 IDs](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)