View a markdown version of this page

AWS X-Ray 示例应用程序 - AWS X-Ray

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWS X-Ray 示例应用程序

注意

X-Ray SDK/Daemon 维护通知 — 2026 年 2 月 25 日 AWS X-Ray SDKs/Daemon 将进入维护模式， AWS 将限制 X-Ray SDK 和 Daemon 版本仅用于解决安全问题。有关支持时间表的更多信息，请参阅 X-Ray SDK 和 Daemon Support 时间表。我们建议迁移到 OpenTelemetry。有关迁移到仪器的更多信息 OpenTelemetry，请参阅从 X-Ray 仪器迁移到 OpenTelemetry 仪器。

上线的 AWS X-Ray eb-java-scorekeeep 示例应用程序展示了如何使用软件开发工具包来检测传入的 HTTP 调用 GitHub、DynamoDB AWS X-Ray SDK 客户端和 HTTP 客户端。该示例应用程序用于 CloudFormation 创建 DynamoDB 表、在实例上编译 Java 代码以及无需任何额外配置即可运行 X-Ray 守护程序。

请参阅 Scorekeeep 教程，使用或开始安装和使用带检测功能的 AWS 管理控制台 示例应用程序。 AWS CLI

Scorekeep 使用 AWS X-Ray SDK 来检测传入的 HTTP 调用、DynamoDB SDK 客户端和 HTTP 客户端

该示例包括前端 Web 应用程序、所调用的 API 以及它用于存储数据的 DynamoDB 表。包含过滤器、插件和经过检测的 AWS SDK 客户端的基本插件显示在项目的xray-gettingstarted分支中。这是您在入门教程中部署的分支。由于此分支只包含基本分析，您可以根据 master 分支比较差异，以快速理解基本分析。

服务地图显示客户端连接到 Scorekeeep 容器，该容器连接到 DynamoDB 表格和 SNS。

该应用程序示例在这些文件中显示基本检测：

该应用程序的 xray 分支包含对 HTTPClient、注释、SQL 查询、自定义子分段、检测过的 AWS Lambda 函数以及检测过的初始化代码和脚本的使用。

为了支持用户登录和在浏览器中 适用于 JavaScript 的 AWS SDK 使用，该xray-cognito分支机构添加了 Amazon Cognito 来支持用户身份验证和授权。通过从 Amazon Cognito 检索到的凭证，该网络应用程序还会向发送跟踪数据， X-Ray 以便从客户的角度记录请求信息。浏览器客户端在跟踪地图中显示为自己的节点，并记录其他信息，包括用户正在查看的页面的 URL 和用户的 ID。

最后，xray-worker 分支将添加独立运行的检测过的 Lambda 函数，并处理来自 Amazon SQS 队列的项目。每当游戏结束时，Scorekeep 就会向队列添加一个项目。由 CloudWatch 事件触发的 Lambda 工作程序每隔几分钟从队列中提取项目，然后对其进行处理，以便将游戏记录存储在 Amazon S3 中以供分析。

主题