我要如何使用 Amazon CloudWatch 監控 AWS API 呼叫的使用量？

簡短描述

您每秒可以進行的 AWS API 呼叫的次數有限。超過此限制後，您會收到超出速率錯誤，且後續的 API 呼叫將會受到節流。如需關於判定導致超出速率錯誤的 API 呼叫的詳細資訊，請參閲如何找出導致「超出速率」錯誤的 AWS API？

如果您在自動化中使用 API 呼叫，則最佳實務是監控您的使用量，以避免超出速率錯誤。Amazon CloudWatch 會收集追蹤某些 AWS 服務使用量的指標。這些指標對應至 AWS 服務配額。按照本文中的步驟來繪製這些指標的圖形並將您的使用量視覺化。

解決方案

使用此方法可以檢查並監控會發佈使用量指標的所有 AWS 資源的使用量。本範例使用 PutMetricData。

1. 在CloudWatch 服務配額文件中檢查 PutMetricData API 呼叫的預設限制。您還可以使用Service Quotas 主控台檢查您帳戶套用的限制。
2. 開啟 CloudWatch 主控台。
3. 在導覽窗格中，選擇 Metrics (指標)，然後選擇 All metrics (所有指標)。
4. 使用量指標發佈在命名空間 AWS/Usage 之下。選擇此命名空間，然後篩選要繪製圖形的 API 呼叫。在此情況下，請選擇 PutMetricData。
5. 選擇 CallCount 指標。此指標提供進行 API 操作次數的計數。
6. 選擇 Graphed metrics (圖形化指標)，然後選擇要檢查使用量的時間範圍。在此情況下，請選擇收到超出速率錯誤的範圍。
7. 對於 Period (期間)，選擇 1 minute (1 分鐘)，Statistic (統計數字) 則選擇 SUM。此會提供每分鐘進行的 API 呼叫總數。**注意：**大部分 API 呼叫都會限制每秒進行的 API 呼叫次數。這是以每秒異動數 (TPS) 來衡量。對於 PutMetricData，限制為 150 TPS。
8. 若要檢視當前使用量，請選擇 Add math (新增數學)，然後選擇 Start with empty expression (以空白表達式開始)。
9. 在新一行中，輸入以下內容：

SERVICE_QUOTA(m1)

---

相關資訊

CloudWatch 使用量指標

服務配額視覺化