# 通过 API Gateway 使用 Amazon X-Ray 服务地图和跟踪视图
<a name="apigateway-using-xray-maps"></a>

在本节中，您可以找到有关如何借助 API Gateway 使用 [Amazon X-Ray](https://docs.amazonaws.cn/xray/latest/devguide/xray-services-apigateway.html) 服务映射和跟踪视图的详细信息。

**Topics**
+ [X-Ray 服务地图示例](#apigateway-using-xray-maps-active)
+ [X-Ray 跟踪视图示例](#apigateway-using-xray-trace-view-active)

## X-Ray 服务地图示例
<a name="apigateway-using-xray-maps-active"></a>

Amazon X-Ray 服务地图显示有关您的 API 及其所有下游服务的信息。在 API Gateway 中为 API 阶段启用 X-Ray 时，在服务地图中，您将看到一个包含有关 API Gateway 服务耗费的全部时间的节点。您可以获取有关响应状态和直方图所选时间范围的 API 响应时间。对于与Amazon服务（如 Amazon Lambda 和 Amazon DynamoDB）集成的 API，您将看到更多节点提供与这些服务相关的性能指标。每个 API 阶段将有一个服务地图。

以下示例显示了名为 `test` API 的 `xray` 阶段的一个服务地图。此 API 有两个 Lambda 集成。节点表示 API Gateway 服务和两个 Lambda 函数。

有关服务地图结构的详细说明，请参阅[使用 X-Ray 跟踪地图](https://docs.amazonaws.cn/xray/latest/devguide/aws-xray-interface-console.html#xray-console-servicemap)。

您可以在服务地图中进行放大，查看您的 API 阶段的跟踪视图。跟踪将显示与您的 API 相关的深度信息，以分段和子分段的方式显示。例如，上面所示的服务地图跟踪包括 Lambda 服务和 Lambda 函数的分段。有关更多信息，请参阅 [Amazon Lambda 和 Amazon X-Ray](https://docs.amazonaws.cn/xray/latest/devguide/xray-services-lambda.html)。

如果您在 X-Ray 服务地图上选择一个节点或边缘，X-Ray 控制台会显示一个延迟分布直方图。您可以使用延迟直方图查看一项服务所需的时长以完成其请求。下面是 API Gateway 阶段的直方图，在之前的服务地图中名为 `xray/test`。有关延迟分配直方图的详细说明，请参阅[使用延迟直方图](https://docs.amazonaws.cn/xray/latest/devguide/aws-xray-interface-console.html#xray-console-histograms)。

## X-Ray 跟踪视图示例
<a name="apigateway-using-xray-trace-view-active"></a>

下图显示了为上述的示例 API 生成的跟踪视图，其中具有 Lambda 后端函数。成功的 API 方法请求的响应代码显示为 200。

有关跟踪视图的详细说明，请参阅[查看跟踪和跟踪详细信息](https://docs.amazonaws.cn/xray/latest/devguide/aws-xray-interface-console.html#xray-console-traces)。