本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 AWS X-Ray 服務映射和追蹤檢視搭配 API Gateway
本節提供如何搭配 API Gateway 使用 [AWS X-Ray](https://docs.aws.amazon.com/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 服務地圖
AWS X-Ray 服務映射會顯示 API 及其所有下游服務的相關資訊。在 API Gateway 中為 API 階段啟用 X-Ray 後，您會在服務對應中看到節點，其中包含 API Gateway 服務中所花費整體時間的相關資訊。您可以取得所選時間範圍內 API 回應時間之回應狀態和長條圖的詳細資訊。對於與 AWS Lambda 和 Amazon DynamoDB 等 AWS 服務整合APIs，您會看到更多節點提供與這些服務相關的效能指標。每個 API 階段都會有一個服務對應。
以下範例顯示名為 `test` 之 API `xray` 階段的服務對應。此 API 有兩個 Lambda 整合。這些節點代表 API Gateway 服務和兩個 Lambda 函式。
如需服務圖結構的詳細說明，請參閱[使用 X-Ray 追蹤圖](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-servicemap)。
![\[API Gateway API 階段的服務對應範例\]](http://docs.aws.amazon.com/zh_tw/apigateway/latest/developerguide/images/apigateway-xray-servicemap-2.png)
在服務對應上放大檢視即可查看 API 階段的追蹤檢視。此追蹤可顯示有關 API 的詳細資訊 (以區段和子區段呈現)。例如，上面顯示之服務對應的追蹤包括 Lambda 服務和 Lambda 函數的區段。如需詳細資訊，請參閱 [AWS Lambda 和 AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-lambda.html) 。
如果您在 X-Ray 服務對應上選擇節點或邊緣，X-Ray 主控台會顯示延遲分佈長條圖。您可以使用延遲長條圖來查看服務需要多久時間才能完成其請求。以下是先前服務對應中 API Gateway 階段的長條圖，名為 `xray/test`。如需延遲分佈長條圖的詳細說明，請參閱[使用延遲長條圖](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-histograms)。
![\[API Gateway API 階段的 X-Ray 直方圖\]](http://docs.aws.amazon.com/zh_tw/apigateway/latest/developerguide/images/apigateway-xray-histogram-1.png)
## 範例 X-Ray 追蹤檢視
下圖顯示為上述範例 API 產生的追蹤檢視，搭配 Lambda 後端函式。其中顯示成功的 API 方法請求，以及回應碼 200。
如需追蹤檢視的詳細說明，請參閱[檢視追蹤和追蹤詳細資訊](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-traces)。
![\[已啟用主動追蹤的 API Gateway\]](http://docs.aws.amazon.com/zh_tw/apigateway/latest/developerguide/images/apigateway-xray-traceview-1.png)