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

# 在 AWS 中監控 API Gateway 的工具
<a name="monitoring_automated_manual"></a>

AWS 提供各種工具，您可以用來監控 API Gateway。您可以設定其中一些工具為您自動監控，但其他工具則需要手動介入。建議您盡可能自動化監控任務。

## 中的自動化監控工具 AWS
<a name="monitoring_automated_tools"></a>

您可以使用下列自動化監控工具來監看 API Gateway，並在發生錯誤時回報：
+ **Amazon CloudWatch 警示** – 監看指定時段內的單一指標，並根據與多個時段內給定之閾值相對的指標值來執行一或多個動作。此動作是傳送到 Amazon Simple Notification Service (Amazon SNS) 主題或 Amazon EC2 Auto Scaling 政策的通知。CloudWatch 警示不會只因處於特定狀態就調用動作，狀態必須已變更並已維持一段指定的時間。如需詳細資訊，請參閱[使用 Amazon CloudWatch 指標監控 REST API 執行](monitoring-cloudwatch.md)。
+ **Amazon CloudWatch Logs**：監控、存放及存取來自 AWS CloudTrail 或其他來源的日誌檔案。如需更多詳細資訊，請參閱《*Amazon CloudWatch 使用者指南*》中的[什麼是 CloudWatch Logs？](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html)。
+ **Amazon EventBridge (以前稱為 Amazon CloudWatch Events)**：比對事件，並將事件轉送至一或多個目標函式或串流以進行變更、擷取狀態資訊，以及採取修正動作。如需詳細資訊，請參閱《*Amazon EventBridge 使用者指南*》中的[什麼是 Amazon EventBridge？](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)。
+ **AWS CloudTrail 日誌監控** – 在帳戶之間共用日誌檔案、透過將日誌檔案傳送到 CloudWatch Logs 來即時監控 CloudTrail 日誌檔案、在 Java 中寫入日誌處理應用程式，以及驗證您的日誌檔案在 CloudTrail 交付後並未變更。如需詳細資訊，請參閱《AWS CloudTrail 使用者指南》**中的[使用 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-working-with-log-files.html)。

## 手動監控工具
<a name="monitoring_manual_tools"></a>

監控 API Gateway 的另一個重要部分是手動監控 CloudWatch 警示未涵蓋的項目。API Gateway、CloudWatch 和其他 AWS 主控台儀表板可讓您at-a-glance檢視 AWS 環境的狀態。建議您也檢查 API 執行上的日誌檔。
+ API Gateway 儀表板顯示指定 API 階段在指定時間內的下列統計資料：
  + **API Calls (API 呼叫)**
  + **Cache Hit (快取命中)**，只在啟用 API 快取時。
  + **Cache Miss (快取遺漏)**，只在啟用 API 快取時。
  + **Latency (延遲)**
  + **Integration Latency (整合延遲)**
  + **4XX Error (4XX 錯誤)**
  + **5XX Error (5XX 錯誤)**
+ CloudWatch 首頁會顯示：
  + 目前警示與狀態
  + 警示與資源的圖表
  + 服務運作狀態

  此外，您可以使用 CloudWatch 執行下列動作：
  + 建立[自定儀表板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)來監控您注重的服務
  + 用於疑難排解問題以及探索驅勢的圖形指標資料。
  + 搜尋和瀏覽您的所有 AWS 資源指標
  + 建立與編輯要通知發生問題的警示

## 建立 CloudWatch 警示來監控 API Gateway
<a name="creating_alarms"></a>

您可以建立 CloudWatch 警報，在警示變更狀態時傳送 Amazon SNS 訊息。警示會監看指定時段內的單一指標，並根據與多個時段內指定閾值相對的指標值來執行一或多個動作。此動作是傳送到 Amazon SNS 主題或 Auto Scaling 政策的通知。警示僅會針對持續狀態變更呼叫動作。CloudWatch 警示不會只因處於特定狀態就調用動作，狀態必須已變更並已維持一段指定的時間。