本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 API Gateway 中使用 X-Ray 追蹤使用者對 REST API 的請求
<a name="apigateway-xray"></a>

您可以使用 [AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-apigateway.html)，在使用者請求通過 Amazon API Gateway REST API 進入基礎服務時追蹤及分析這些請求。API Gateway 支援所有 API Gateway REST API 端點類型的 X-Ray 追蹤：區域性、邊緣最佳化和私有。您可以在適用 X-Ray 的所有 AWS 區域中將 X-Ray 與 Amazon API Gateway 搭配使用。

X-Ray 提供整個請求的端對端檢視，因此您可以在 API 及其後端服務中分析延遲。您可以使用 X-Ray 服務對應來檢視整個請求的延遲，以及與 X-Ray 整合之下游服務的延遲。您也可以設定取樣規則，以根據您指定的條件告知 X-Ray 要記錄那些請求，以及使用何種取樣率。

如果您從已被追蹤的服務呼叫 API Gateway API，即使 API 上未啟用 X-Ray 追蹤，API Gateway 也會傳遞追蹤。

您可以使用 API Gateway 主控台或使用 API Gateway API 或 CLI，為 API 階段啟用 X-Ray。

**Topics**
+ [AWS X-Ray 使用 API Gateway REST APIs設定](apigateway-enabling-xray.md)
+ [使用 AWS X-Ray 服務映射和追蹤檢視搭配 API Gateway](apigateway-using-xray-maps.md)
+ [設定 API Gateway APIs的 AWS X-Ray 抽樣規則](apigateway-configuring-xray-sampling-rules.md)
+ [AWS X-Ray Amazon API Gateway APIs追蹤](apigateway-understanding-xray-traces.md)