Amazon API Gateway 活动跟踪支持Amazon X-Ray - Amazon X-Ray
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

Amazon API Gateway 活动跟踪支持Amazon X-Ray

当用户请求通过 Amazon API Gateway API 传输到基础服务时,您可以使用 X-Ray 对用户请求进行跟踪和分析。API Gateway 支持所有 API Gateway 终端节点类型的 X-Ray 跟踪:区域、边缘优化和私有。您 X-Ray 以 Amazon API Gateway 有Amazon提供 X-Ray 的区域。有关更多信息,请参阅 。使用跟踪 API Gateway API 执行Amazon X-Ray(在 Amazon API Gateway 开发人员指南中。

注意

X-Ray 仅支持通过 API Gateway 对 REST API 进行跟踪。

Amazon API Gateway 提供活动跟踪支持Amazon X-Ray。在 API 阶段启用活动跟踪以对传入请求进行采样,并将跟踪发送到 X-Ray。

在 API 阶段启用活动跟踪

  1. 通过以下网址打开 API Gateway 控制台:https://console.aws.amazon.com/apigateway/

  2. 选择一个 API。

  3. 选择一个阶段。

  4. 在存储库的日志 /跟踪选项卡上,选择启用 X-Ray 跟踪

  5. 选择资源在左侧导航面板中。

  6. 要使用新设置重新部署 API,请选择操作部署 API

API Gateway 使用您在 X-Ray 控制台中定义的采样规则来确定要记录的请求。您可以创建仅适用于 API 的规则,或者仅适用于包含特定标头的请求的规则。API Gateway 将记录分段上属性中的标头以及有关阶段和请求的详细信息。有关更多信息,请参阅 在 X-Ray 控制台中配置采样规则

对于所有传入的请求,API Gateway 将跟踪标头传入到还没有已有 HTTP 请求。

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793

跟踪 ID 格式

trace_id 由以连字符分隔的三组数字组成。例如:1-58406520-a006649127e371903a2de979。这包括:

  • 版本号,即 1

  • 原始请求的时间,采用 Unix 纪元时间,为 8 个十六进制数字

    例如,2016 年 12 月 1 日上午 10:00 (太平洋标准时间) 采用纪元时间为 1480615200,或者是十六进制数字 58406520

  • 跟踪的 96 位标识符,全局唯一,使用 24 个十六进制数字

如果禁用活动跟踪,则如果请求来自对请求进行采样并启动跟踪的服务,则阶段仍会记录段。例如,已检测的 Web 应用程序可通过 HTTP 客户端调用 API Gateway API。当您使用 X-Ray 开发工具包检测 HTTP 客户端时,将向包含采样决策的传出请求添加到。API Gateway 读取跟踪标头并为采样请求创建一个段。

如果您使用 API Gateway为您的 API 生成 Java 开发工具包,您可以通过向客户端生成器添加一个请求处理程序来检测开发工具包客户端,这与您手动检测Amazon开发工具包客户端。有关说明,请参阅跟踪Amazon使用适用于 Java 的 X-Ray 开发工具包调用