使用 Amazon CloudWatch 監控 Amazon EC2 API 請求 Amazon CloudWatch - Amazon Elastic Compute Cloud
啟用 Amazon EC2 API 指標Amazon EC2 API 指標和維度指標資料保留監控代表您提出的請求帳單使用 Amazon CloudWatch

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

使用 Amazon CloudWatch 監控 Amazon EC2 API 請求 Amazon CloudWatch

您可以使用 Amazon CloudWatch 監控 Amazon EC2 API 請求，這會收集原始資料並將其處理為可讀且近乎即時的指標。 Amazon CloudWatch 這些指標提供一種簡單的方法來追蹤 Amazon EC2 API 操作隨時間的使用情況和結果。此資訊可讓您更清楚地了解 Web 應用程式的效能，並可讓您識別和診斷各種問題。您也可以設定監控特定閾值的警示，並在達到這些閾值時傳送通知或採取特定動作。

如需有關 CloudWatch 的詳細資訊，請參閱《Amazon CloudWatch 使用者指南》。

重要

Amazon EC2 API 指標是一項選擇加入功能。您必須請求存取此功能。如需詳細資訊，請參閱啟用 Amazon EC2 API 指標。

啟用 Amazon EC2 API 指標

使用下列程序，為您的 請求存取此功能 AWS 帳戶。

請求存取此功能

  1. 開啟AWS 支援 中心。

  2. 選擇建立案例。

  3. 選擇 帳戶和帳單。

  4. 針對服務，選擇一般資訊和入門。

  5. 針對類別，選擇使用 AWS &服務。

  6. 選擇 Next step: Additional information (下一步：其他資訊)。

  7. 對於 Subject (主旨)，請輸入 Request access to Amazon EC2 API metrics。

  8. 對於 Description (說明)，輸入 Please grant my account access to Amazon EC2 API metrics. Related page: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/monitor.html。也包括您需要存取的區域。

  9. 選擇下一步驟：立即解決或聯絡我們。

  10. 在聯絡我們索引標籤上，選擇您偏好的聯絡語言和聯絡方式。

  11. 選擇提交。

Amazon EC2 API 指標和維度

指標

Amazon EC2 API 指標包含在 AWS/EC2/API 命名空間中。下表列出 Amazon EC2 API 請求可用的指標。

指標 描述

ClientErrors

用戶端錯誤導致的失敗 API 請求數目。

這些錯誤通常是由用戶端執行的作業所造成，例如在請求中指定不正確或無效的參數，或是代表沒有動作或資源使用許可的使用者使用動作或資源。

單位：計數

RequestLimitExceeded

您的帳戶超過 Amazon EC2 APIs 允許的最大請求率的次數。

Amazon EC2 API 請求會受到調節，以協助維持服務的效能。如果您的請求已調節，您會收到Client.RequestLimitExceeded錯誤。

單位：計數

ServerErrors

內部伺服器錯誤導致的失敗 API 請求數目。

這些錯誤通常是由 AWS 伺服器端錯誤、例外狀況或失敗所造成。

單位：計數

SuccessfulCalls

成功的 API 請求數量。

單位：計數

維度

Amazon EC2 指標資料可以篩選所有 EC2 API 動作。如需維度的詳細資訊，請參閱 Amazon CloudWatch 概念。

指標資料保留

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 定價。

使用 Amazon CloudWatch

檢視 CloudWatch 指標

使用下列程序來檢視 Amazon EC2 API 指標。

先決條件

您必須啟用您帳戶的 Amazon EC2 API 指標存取權。如需詳細資訊，請參閱啟用 Amazon EC2 API 指標。

使用主控台檢視 Amazon EC2 API 指標

  1. 透過 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

  2. 在導覽窗格中，選擇指標、所有指標。

  3. 在瀏覽索引標籤的指標下，選取要檢視指標的所需區域。

  4. 選擇 EC2 指標命名空間。

  5. 若要檢視指標，請選取指標維度，例如每個執行個體指標。

    注意

    指標會在閒置兩週後隱藏。如果他們在過去兩週內沒有收到新的資料點，則不會再出現在主控台中，當您在主控台搜尋方塊中輸入其指標名稱或維度名稱時，就不會顯示，且 list-metrics AWS CLI 命令也不會傳回。若要擷取這些指標，請使用 get-metric-data 或 get-metric-statistics 命令。

使用命令列檢視 Amazon EC2 API 指標

請使用以下其中一個命令：

  • list-metrics (AWS CLI)

    aws cloudwatch list-metrics --namespace "AWS/EC2/API"

  • Get-CWMetricList (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 指標。

為 Amazon EC2 DescribeInstances API 請求伺服器錯誤建立警示

  1. 透過 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

  2. 在導覽窗格中，選擇 Alarms (警示)、All alarms (所有警示)。

  3. 選擇 Create alarm (建立警示)。

  4. 選擇選取指標，然後指定下列項目：

    1. 選擇 EC2/API。

    2. 選擇每個動作指標。

    3. 選取 DescribeInstances 旁的核取方塊，其與 ServerErrors 指標名稱位於同一列。

    4. 選擇選取指標。

  5. Specify metric and conditions (指定指標和條件) 頁面隨即出現，顯示您所選取指標和統計資料的圖形及其他資訊。

    1. 在指標下，指定下列項目：

      1. 在 Statistic (統計資料) 中選擇 Sum (總和)。

      2. 對於期間，請確認已選取 5 分鐘。

    2. 在 Conditions (條件) 下，指定以下內容：

      1. 對於閾值類型，選擇靜態。

      2. 對於每當 ServerErrors 為 時，選擇大於/等於 >=。

      3. 針對 ...，輸入 10。

    3. 選擇 Next (下一步)。

  6. Configure actions (設定動作) 頁面隨即顯示。

    1. 在通知下，指定下列項目：

      1. 針對 Alam 狀態觸發，選擇進入警示。

      2. 針對選取 SNS 主題，選擇選取現有的 SNS 主題或建立新主題，然後完成通知的必要欄位。

      3. 選擇 Next (下一步)。

  7. 隨即顯示新增名稱和描述頁面。

    1. 針對警示名稱，輸入警示的名稱。名稱只能包含 ASCII 字元。

    2. 針對警示描述，輸入警示的選用描述。

    3. 選擇 Next (下一步)。

  8. 預覽和建立頁面隨即出現。驗證資訊是否正確，然後選擇建立警示。

如需詳細資訊，請參閱《Amazon CloudWatch 使用者指南》中的使用 Amazon CloudWatch 警示。