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

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

使用 Amazon 監控 Amazon EC2API請求 CloudWatch

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

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

重要

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

啟用 Amazon EC2API指標

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

請求存取此功能

  1. 開啟AWS Support 中心 。

  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 EC2API指標和維度

指標

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

指標 描述

ClientErrors

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

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

單位：計數

RequestLimitExceeded

您的帳戶EC2APIs超過 Amazon 允許的請求率上限的次數。

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

單位：計數

ServerErrors

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

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

單位：計數

SuccessfulCalls

成功API請求的數量。

單位：計數

維度

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

指標資料保留

Amazon EC2API指標 CloudWatch 會以 1 分鐘的間隔傳送至 。 CloudWatch 會保留指標資料，如下所示：

  • 含少於 60 秒期間 (1 分鐘) 的資料點可供使用 15 天。

  • 具有 300 秒 （5 分鐘） 期間的資料點可供 63 天使用。

  • 具有 3600 秒 （1 小時） 期間的資料點可供 455 天 （15 個月） 使用。

監控代表您提出的請求

API AWS 服務代表您提出的請求，例如服務連結角色提出的請求，不會計入您的API限流限制，也不會 CloudWatch 為您的帳戶將指標傳送至 Amazon。無法使用 監控這些請求 CloudWatch。

API 第三方服務供應商代表您提出的請求確實會計入您的API限流限制，而且它們會 CloudWatch 針對您的帳戶將指標傳送至 Amazon。您可以使用 監控這些請求 CloudWatch。

帳單

適用標準 CloudWatch 定價和費用。使用 Amazon EC2API指標不會收取額外費用。如需詳細資訊，請參閱 Amazon CloudWatch Pricing 。

使用 Amazon CloudWatch

檢視 CloudWatch 指標

使用下列程序檢視 Amazon EC2API指標。

先決條件

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

使用主控台檢視 Amazon EC2API指標

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

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

  3. 在瀏覽索引標籤上，選擇 EC2/API 指標命名空間。

  4. 若要檢視指標，請選取指標維度。

使用命令列檢視 Amazon EC2API指標

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

  • 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主題。

例如，您可以建立警示，監控因伺服器端錯誤而失敗的API請求數量 DescribeInstances。下列警示會在 5 分鐘內請求失敗次數 DescribeInstances API達到 10 個伺服器端錯誤的閾值時傳送電子郵件通知。

先決條件

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

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

  1. 在 開啟 CloudWatch 主控台https://console.aws.amazon.com/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 使用者指南 中的使用 Amazon CloudWatch 警示。 CloudWatch