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

# Amazon Lambda 和 Amazon X-Ray
Lambda

**注意**  
X-Ray SDK/Daemon 维护通知 — 2026 年 2 月 25 日， Amazon X-Ray SDKs/Daemon 将进入维护模式，在该模式下，X-Ray SDK 和 Daemon 的发布 Amazon 将仅限于解决安全问题。有关支持时间表的更多信息，请参阅 [X-Ray SDK 和 Daemon Support 时间表](xray-sdk-daemon-timeline.md)。我们建议迁移到 OpenTelemetry。有关迁移到的更多信息 OpenTelemetry，请参阅[从 X-Ray 仪器迁移到 OpenTelemetry 仪器](https://docs.amazonaws.cn/xray/latest/devguide/xray-sdk-migration.html)。

您可以使用 Amazon X-Ray 来跟踪您的 Amazon Lambda 函数。Lambda 运行 [X-Ray 进程守护程序](xray-daemon.md)并使用有关函数调用和运行该函数的详细信息记录分段。如需进一步检测，您可以将 X-Ray SDK 与您的函数绑定，以便记录传出调用以及添加注释和元数据。

如果您的 Lambda 函数由另一个已检测服务调用，则 Lambda 会跟踪已采样的请求，无需任何额外配置。上游服务可以是经过检测的 Web 应用程序或另一个 Lambda 函数。您的服务可以使用经过检测的 Amazon SDK 客户端直接调用该函数，也可以使用经过检测的 HTTP 客户端调用 API Gateway API。

Amazon X-Ray 支持使用 Amazon Lambda 和 Amazon SQS 跟踪事件驱动的应用程序。使用 CloudWatch 控制台查看每个请求在 Amazon SQS 中排队并由下游 Lambda 函数处理的连接视图。来自上游消息生成者的跟踪会自动链接到来自下游 Lambda 使用者节点的跟踪，从而创建 end-to-end应用程序视图。有关更多信息，请参阅[跟踪事件驱动型应用程序](xray-tracelinking.md)。

**注意**  
如果您为下游 Lambda 函数启用了跟踪，则还必须为调用下游函数的根 Lambda 函数启用跟踪，以便下游函数生成跟踪。

如果您的 Lambda 函数按计划运行，或者由未检测的服务调用，您可以将 Lambda 配置为通过活动跟踪采样和记录调用。

**在 Amazon Lambda 函数上配置 X-Ray 集成**

1. 打开 [Amazon Lambda 控制台](https://console.amazonaws.cn/lambda)。

1. 从左侧导航栏中，选择**函数**。

1. 选择您的函数。

1. 在**配置**选项卡中，向下滚动到**其他监控工具**卡片。您也可以通过选择左侧导航窗格中的**监控和操作工具**来找到此卡片。

1. 选择**编辑**。

1. 在 **Amazon X-Ray** 下，启用**活动跟踪**。

在运行时，通过对应的 X-Ray SDK，Lambda 也运行 X-Ray 进程守护程序。

**Lambda SDKs 上的 X-Ray**
+ ** X-Ray SDK for G** – Go 1.7 和更新版本的运行时
+ ** X-Ray SDK for Java** – Java 8 运行时
+ ** X-Ray SDK for Node.js** – Node.js 4.3 和更高版本的运行时
+ ** X-Ray SDK for Python** – Python 2.7、Python 3.6 和更新版本的运行时
+ **X-Ray SDK for .NET** – .NET Core 2.0 和更新版本的运行时

要在 Lambda 上使用 X-Ray SDK，请在每次创建新版本时将其与您的函数代码绑定。您可以用检测运行在其他服务上的应用程序的相同方法来检测您的 Lambda 函数。主要差别在于您不使用 SDK 来检测传入请求、做出采样决策和创建分段。

检测 Lambda 函数和 Web 应用程序的另一个差别在于，Lambda 创建并发送到 X-Ray 的分段无法通过函数代码进行修改。您可以创建子分段并在其上记录注释和元数据，但无法将批注和元数据添加到父分段。

有关更多信息，请参阅 *Amazon Lambda 开发人员指南*中的[使用 Amazon X-Ray](https://docs.amazonaws.cn/lambda/latest/dg/lambda-x-ray.html)。