# 在 API Gateway 中使用 X-Ray 跟踪用户对 REST API 的请求
<a name="apigateway-xray"></a>

当用户请求通过 Amazon API Gateway REST API 传输到底层服务时，您可以使用 [Amazon X-Ray](https://docs.amazonaws.cn/xray/latest/devguide/xray-services-apigateway.html) 对用户请求进行跟踪和分析。API Gateway 支持对所有 API Gateway REST API 终端节点类型进行 X-Ray 跟踪：区域、边缘优化和私有。您可以在提供 X-Ray 的所有Amazon区域中将 X-Ray 与 Amazon API Gateway 结合使用。

X-Ray 为您提供了整个请求的端到端视图，因此您可以分析 API 及其后端服务中的延迟。您可以使用 X-Ray 服务地图，以查看整个请求的延迟及集成了 X-Ray 的下游服务的延迟。您还可以配置采样规则，以告知 X-Ray 根据您指定的标准以哪种采样率记录哪些请求。

如果您从正在跟踪的服务中调用 API Gateway，则 API Gateway 会通过跟踪，即使 X-Ray 跟踪在 API 上未启用。

您可以使用 API Gateway 控制台或使用 API Gateway API 或 CLI 为 API 阶段启用 X-Ray。

**Topics**
+ [使用 API Gateway REST API 设置 Amazon X-Ray](apigateway-enabling-xray.md)
+ [通过 API Gateway 使用 Amazon X-Ray 服务地图和跟踪视图](apigateway-using-xray-maps.md)
+ [为 API Gateway API 配置 Amazon X-Ray 采样规则](apigateway-configuring-xray-sampling-rules.md)
+ [Amazon API Gateway API 的 Amazon X-Ray 跟踪](apigateway-understanding-xray-traces.md)