本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon CloudWatch 監控 Amazon EC2 API 請求 Amazon CloudWatch
您可以使用 Amazon CloudWatch 監控 Amazon EC2 API 請求，該請求會收集原始資料並將其處理為可讀且近乎即時的指標。 Amazon CloudWatch 這些指標提供簡單的方法來追蹤 Amazon EC2 API 操作隨時間的使用情況和結果。此資訊可讓您更清楚 Web 應用程式的效能，並可讓您識別和診斷各種問題。您也可以設定監控特定閾值的警示，並在達到這些閾值時傳送通知或採取特定動作。
如需有關 CloudWatch 的詳細資訊，請參閱《[Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)》。
**重要**
Amazon EC2 API 指標是一項選擇加入功能。您必須請求存取此功能。如需詳細資訊，請參閱[啟用 Amazon EC2 API 指標](#enable-ec2-api-metrics)。
**Topics**
+ [啟用 Amazon EC2 API 指標](#enable-ec2-api-metrics)
+ [Amazon EC2 API 指標和維度](#monitor-metrics_dimensions)
+ [指標資料保留](#monitor-retention)
+ [監控代表您提出的請求](#throttling-metrics)
+ [帳單](#monitor-billing)
+ [使用 Amazon CloudWatch](#monitor-using)
## 啟用 Amazon EC2 API 指標
使用下列程序為您的 請求存取此功能 AWS 帳戶。
**請求存取此功能**
1. 開啟[AWS 支援 中心](https://console.aws.amazon.com/support/home#/)。
1. 選擇**建立案例**。
1. 選擇 **帳戶和帳單**。
1. 針對**服務**，選擇**一般資訊和入門**。
1. 針對**類別**，選擇**使用 AWS & 服務**。
1. 選擇 **Next step: Additional information** (下一步：其他資訊)。
1. 對於 **Subject (主旨)**，請輸入 **Request access to Amazon EC2 API metrics**。
1. 對於 **Description (說明)**，輸入 **Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html**。同時包含您需要存取的區域。
1. 選擇**下一步驟：立即解決或聯絡我們**。
1. 在**聯絡我們**索引標籤上，選擇您偏好的聯絡語言和聯絡方式。
1. 選擇**提交**。
## Amazon EC2 API 指標和維度
### 指標
Amazon EC2 API 指標包含在 `AWS/EC2/API` 命名空間中。下表列出 Amazon EC2 API 請求可用的指標。
| 指標 | Description |
| --- | --- |
| `ClientErrors` | 用戶端錯誤導致的失敗 API 請求數目。 這些錯誤通常是由用戶端執行的作業所造成，例如在請求中指定不正確或無效的參數，或代表沒有動作或資源使用許可的使用者使用動作或資源。 單位：計數 |
| `RequestLimitExceeded` | 您的帳戶超過 Amazon EC2 APIs 允許的最大請求率的次數。 Amazon EC2 API 請求會受到調節，以協助維持服務的效能。如果您的請求已受到調節，您會收到`Client.RequestLimitExceeded`錯誤。 單位：計數 |
| `AwsTriggeredRequestLimitExceeded` | 因操作問題而 AWS 套用的調節所導致的失敗 API 請求數目。 發生此限流時，您會收到`Client.RequestLimitExceeded`錯誤訊息，指出您的請求已因 AWS 操作問題而受到限流。此限流是暫時的，一旦解決操作問題， 會自動解決。實作指數退避和重試邏輯，以正常處理這些暫時調節。 單位：計數 |
| `ServerErrors` | 內部伺服器錯誤導致的失敗 API 請求數目。 這些錯誤通常是由 AWS 伺服器端錯誤、例外狀況或失敗所造成。 單位：計數 |
| `SuccessfulCalls` | 成功的 API 請求數量。 單位：計數 |
### 維度
Amazon EC2 指標資料可以篩選所有 EC2 API 動作。如需維度的詳細資訊，請參閱 [Amazon CloudWatch 概念](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)。
## 指標資料保留
Amazon EC2 API 指標會以 1 分鐘的間隔傳送至 CloudWatch。CloudWatch 保留如下指標資料：
+ 含少於 60 秒期間 (1 分鐘) 的資料點可供使用 15 天。
+ 期間為 300 秒 (5 分鐘） 的資料點可使用 63 天。
+ 期間為 3600 秒 (1 小時） 的資料點可供 455 天 (15 個月） 使用。
## 監控代表您提出的請求
AWS 服務代表您提出的 API 請求，例如服務連結角色提出的請求，不會計入您的 API 限流限制，也不會將指標傳送至您帳戶的 Amazon CloudWatch。無法使用 CloudWatch 監控這些請求。
第三方服務供應商代表您提出的 API 請求會計入您的 API 限流限制，而且它們會將指標傳送至您帳戶的 Amazon CloudWatch。您可以使用 CloudWatch 監控這些請求。
## 帳單
適用標準 CloudWatch 定價和費用。使用 Amazon EC2 API 指標不會產生額外費用。如需詳細資訊，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing/)。
## 使用 Amazon CloudWatch
**Contents**
+ [檢視 CloudWatch 指標](#monitor-using-viewing)
+ [建立 CloudWatch 警示](#monitor-creating)
### 檢視 CloudWatch 指標
使用下列程序來檢視 Amazon EC2 API 指標。
**先決條件**
您必須為您的帳戶啟用 Amazon EC2 API 指標的存取權。如需詳細資訊，請參閱[啟用 Amazon EC2 API 指標](#enable-ec2-api-metrics)。
**使用主控台檢視 Amazon EC2 API 指標**
1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。
1. 在導覽窗格中，選擇**指標**、**所有指標**。
1. 在**瀏覽**索引標籤的**指標**下，選取要檢視指標的所需區域。
1. 選擇 **EC2** 指標命名空間。
1. 若要檢視指標，請選取指標維度，例如**每個執行個體指標**。
**注意**
指標會在閒置兩週後隱藏。如果他們在過去兩週內沒有收到新的資料點，則不會再出現在主控台中，當您在主控台搜尋方塊中輸入其指標名稱或維度名稱時，就不會顯示，也不會由 [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) AWS CLI 命令傳回。若要擷取這些指標，請使用 [get-metric-data]() 或 [get-metric-statistics]() 命令。
**使用命令列檢視 Amazon EC2 API 指標**
請使用以下其中一個命令：
+ [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) (AWS CLI)
```
aws cloudwatch list-metrics --namespace "AWS/EC2/API"
```
+ [Get-CWMetricList](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-CWMetricList.html) (AWS Tools for Windows PowerShell)
```
Get-CWMetricList -Namespace "AWS/EC2/API"
```
### 建立 CloudWatch 警示
您可以建立 CloudWatch 警報，在警示變更狀態時傳送 Amazon SNS 訊息。警示會在您指定的期間監看單一指標。它會根據指標在多個期間內相對於指定閾值的值，傳送通知至 SNS 主題。
例如，您可以建立警示來監控因伺服器端錯誤而失敗的 DescribeInstances API 請求數目。當 DescribeInstances API 請求失敗的數量在 5 分鐘內達到 10 個伺服器端錯誤的閾值時，以下警示會傳送電子郵件通知。
**先決條件**
您必須啟用您帳戶的 Amazon EC2 API 指標存取權。如需詳細資訊，請參閱[啟用 Amazon EC2 API 指標](#enable-ec2-api-metrics)。
**為 Amazon EC2 DescribeInstances API 請求伺服器錯誤建立警示**
1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。
1. 在導覽窗格中，選擇 **Alarms** (警示)、**All alarms** (所有警示)。
1. 選擇 **Create alarm** (建立警示)。
1. 選擇**選取指標**，然後指定下列項目：
1. 選擇 **EC2/API**。
1. 選擇**每個動作指標**。
1. 選取 **DescribeInstances** 旁的核取方塊，其與 **ServerErrors** 指標名稱位於同一列。
1. 選擇**選取指標**。
1. **Specify metric and conditions (指定指標和條件)** 頁面隨即出現，顯示您所選取指標和統計資料的圖形及其他資訊。
1. 在**指標**下，指定下列項目：
1. 在 **Statistic (統計資料)** 中選擇 **Sum (總和)**。
1. 針對**期間**，確認已選取 **5 分鐘**。
1. 在 **Conditions (條件)** 下，指定以下內容：
1. 對於**閾值類型**，選擇**靜態**。
1. 對於**每當 ServerErrors 為** 時，選擇**大於/等於** **>=**。
1. 針對 **than...**，輸入 **10**。
1. 選擇**下一步**。
1. **Configure actions** (設定動作) 頁面隨即顯示。
1. 在**通知**下，指定下列項目：
1. 針對 **Alam 狀態觸發**，選擇**警示中**。
1. 針對**選取 SNS 主題**，選擇**選取現有的 SNS 主題**或**建立新主題**，然後完成通知的必要欄位。
1. 選擇**下一步**。
1. 新增**名稱和描述**頁面隨即出現。
1. 在**警示名稱**中，輸入警示的名稱。名稱只能包含 ASCII 字元。
1. 針對**警示描述**，輸入警示的選用描述。
1. 選擇**下一步**。
1. **預覽和建立**頁面隨即出現。驗證資訊是否正確，然後選擇**建立警示**。
如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》**中的[使用 Amazon CloudWatch 警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)。