AWS Lambda
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

使用 Lambda 设置 AWS X-Ray

以下是利用 Lambda 设置 X-Ray 的详细信息。

在您开始之前

要使用 Lambda CLI 启用对 Lambda 函数的跟踪,您必须首先对函数的执行角色添加跟踪权限。要实现此目的,请执行以下步骤:

  • 登录 AWS 管理控制台 并通过以下网址打开 IAM 控制台 https://console.amazonaws.cn/iam/

  • 查找您的 Lambda 函数的执行角色。

  • 附加以下托管策略:AWSXrayWriteOnlyAccess

要了解有关这些策略的更多信息,请参阅 AWS X-Ray

如果您要使用 Lambda 控制台将跟踪模式更改为“活跃”,将如下节所述,自动添加跟踪权限。

跟踪

通过跟踪 ID 来跟踪请求在您的应用程序中传输的路径。跟踪会收集单个请求 (通常是 HTTP GET 或 POST 请求) 生成的所有分段。

Lambda 函数的跟踪有两种模式:

  • 传递:如果您为函数的执行角色添加了跟踪权限,这是所有 Lambda 函数的默认设置。此方法意味着,只有上游服务(例如 AWS Elastic Beanstalk)启用 X-Ray 后才会跟踪 Lambda 函数。

  • 活跃:如果 Lambda 函数具有此设置,Lambda 会自动根据 X-Ray 指定的采样算法对调用请求进行采样。

    注意

    X-Ray 应用采样算法确保跟踪有效,同时为应用程序所服务的请求提供代表性样本。默认采样规则是每秒 1 个请求和 5% 的其他请求。

您可以使用 Lambda 管理控制台或 Lambda CreateFunctionUpdateFunctionConfiguration API 操作,更改 Lambda 函数的跟踪模式。

如果您使用 Lambda 控制台,则适用以下规则:

  • 如果您将函数的跟踪模式更改为“活跃”,跟踪权限会自动附加到该函数的执行角色。如果您收到错误信息,说明 Lambda 无法将 AWSXrayWriteOnlyAccess 策略添加到函数的执行角色,请登录 IAM 控制台:https://console.amazonaws.cn/iam/,并手动添加策略。

  • 要启用活动跟踪,请转到 Configuration 选项卡,然后选择 Enable active tracing 框。

如果您使用 Lambda CreateFunctionUpdateFunctionConfiguration API 操作:

  • 如果您希望跟踪模式为“活跃”,请将 TracingConfig 参数的 Mode 属性设置为 Active. 请注意,任何新函数的默认跟踪模式都是 PassThrough

  • 任何新建或更新的 Lambda 函数的 $LATEST 版本均会设置为您指定的值。

    注意

    如果您没有为函数的执行角色添加跟踪权限,将收到一条错误消息。有关更多信息,请参阅 在您开始之前

本页内容: