使用亚马逊监控亚马逊的EC2API请求 CloudWatch - Amazon Elastic Compute Cloud
启用 Amazon EC2 API 指标Amazon 的EC2API指标和维度指标数据保留监控以您的名义提出的请求Billing与亚马逊合作 CloudWatch

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用亚马逊监控亚马逊的EC2API请求 CloudWatch

您可以使用 Amazon 监控亚马逊的EC2API请求 CloudWatch，亚马逊会收集原始数据并将其处理为可读的近乎实时的指标。这些指标提供了一种跟踪一段时间内Amazon EC2 API 运营的使用情况和结果的简单方法。这些信息使您可以更好地了解 Web 应用程序的性能，并使您能够识别和诊断各种问题。您还可以设置警报，监视某些阈值，并在达到这些阈值时发送通知或采取特定操作。

有关的更多信息 CloudWatch，请参阅 Amazon CloudWatch 用户指南。

重要

Amazon EC2 API 指标是一项可选功能。您必须申请访问此功能。有关更多信息，请参阅 启用 Amazon EC2 API 指标。

启用 Amazon EC2 API 指标

使用以下步骤为您申请访问此功能的权限 AWS 账户。

请求访问此功能

  1. 打开AWS Support 中心。

  2. 选择创建案例。

  3. 选择账户和账单。

  4. 对于 “服务”，选择 “一般信息” 和 “入门”。

  5. 在 “类别” 中，选择 “使用 AWS 和服务”。

  6. 选择 Next step: Additional information（下一步：其他信息）。

  7. 对于 Subject (主题)，请输入 Request access to Amazon EC2 API metrics。

  8. 对于描述，输入 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 EC2 API 指标包含在AWS/EC2/API命名空间中。下表列出了可用于 Amazon EC2 API 请求的指标。

指标 描述

ClientErrors

由客户端错误导致的失败API请求数。

这些错误通常是由客户端的行为引起的，例如在请求中指定了不正确或无效的参数，或者代表无权使用操作或资源的用户使用操作或资源。

单位：计数

RequestLimitExceeded

您的账户超出亚马逊EC2APIs允许的最大请求速率的次数。

Amazon 的EC2API请求会受到限制，以帮助维持服务的性能。如果您的请求已被限制，则会出现错误。Client.RequestLimitExceeded

单位：计数

ServerErrors

由内部服务器错误导致的失败API请求数。

这些错误通常是由 AWS 服务器端错误、异常或故障引起的。

单位：计数

SuccessfulCalls

成功API请求的数量。

单位：计数

尺寸

可以在所有EC2API操作中筛选 Amazon EC2 指标数据。有关尺寸的更多信息，请参阅 Amazon CloudWatch 概念。

指标数据保留

亚马逊EC2API指标每隔 1 分钟发送 CloudWatch 一次。 CloudWatch 按如下方式保留指标数据：

  • 时间段为 60 秒（1 分钟）的数据点可用 15 天。

  • 周期为 300 秒（5 分钟）的数据点可用 63 天。

  • 周期为 3600 秒（1 小时）的数据点可用 455 天（15 个月）。

监控以您的名义提出的请求

API AWS 服务代表您发出的请求（例如服务相关角色发出的请求）不计入您的API限制限制，也不会向亚马逊发送您账户 CloudWatch 的指标。无法使用监控这些请求 CloudWatch。

API第三方服务提供商代表您提出的请求会计入您的限制API限制，并且他们会将您账户的指标发送到亚马逊 CloudWatch 。可以使用监控这些请求 CloudWatch。

Billing

适用标准 CloudWatch 定价和费用。使用 Amazon EC2 API 指标不收取任何额外费用。有关更多信息，请参阅 Amazon CloudWatch 定价。

与亚马逊合作 CloudWatch

查看 CloudWatch 指标

使用以下步骤查看 Amazon EC2 API 指标。

先决条件

您必须允许访问您账户的 Amazon EC2 API 指标。有关更多信息，请参阅 启用 Amazon EC2 API 指标。

使用控制台查看 Amazon EC2 API 指标

  1. 打开 CloudWatch 控制台，网址为https://console.aws.amazon.com/cloudwatch/。

  2. 在导航窗格中，选择指标，所有指标。

  3. 在 “浏览” 选项卡上，选择 EC2/m API etric 命名空间。

  4. 要查看指标，请选择指标维度。

使用命令行查看 Amazon EC2 API 指标

使用以下命令之一：

  • 列表指标 ()AWS CLI

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

  • 获取-CWMetricList (AWS Tools for Windows PowerShell)

    Get-CWMetricList -Namespace "AWS/EC2/API"

创建 CloudWatch 警报

您可以创建一个 CloudWatch 警报，当警报状态发生变化时，该警报会发送 Amazon SNS 消息。告警会监控您指定的时间段内的某个指标。它根据指标在多个时间段内相对于给定阈值的值向SNS主题发送通知。

例如，您可以创建一个警报，监控由于服务器端错误而失败的 DescribeInstancesAPI请求数量。当 DescribeInstances API请求失败次数在 5 分钟内达到 10 个服务器端错误的阈值时，以下警报会发送电子邮件通知。

先决条件

您必须允许访问您账户的 Amazon EC2 API 指标。有关更多信息，请参阅 启用 Amazon EC2 API 指标。

要为 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. 选中与ServerErrors指标名称位于同一行旁边的复选框。DescribeInstances

    4. 选择选择指标。

  5. 将显示 Specify metric and conditions（指定指标和条件）页面，其中显示一个图表以及有关您选择的指标和统计数据的其他信息。

    1. 在 “指标” 下，指定以下内容：

      1. 对于 Statistic（统计数据），选择 Sum（总计）。

      2. 在 “时段” 中，确认已选择 5 分钟。

    2. 在条件下面，指定以下内容：

      1. 对于 Threshold type（阈值类型），选择 Static（静态）。

      2. 对于 “无论何时 ServerErrors 是”，选择 “大于/等于 >=”。

      3. 不止于... ，输入 10。

    3. 选择下一步。

  6. Configure actions（配置操作）页面会显示。

    1. 在 “通知” 下，指定以下内容：

      1. 对于 Alam 状态触发器，请选择处于警报状态。

      2. 在 “选择SNS主题” 中，选择 “选择现有SNS主题” 或 “创建新主题”，然后填写通知的必填字段。

      3. 选择下一步。

  7. 将出现 “添加姓名和描述” 页面。

    1. 在警报名称中，输入警报的名称。名称必须仅包含ASCII字符。

    2. 在警报描述中，输入警报的可选描述。

    3. 选择下一步。

  8. 将出现 “预览并创建” 页面。验证信息是否正确，然后选择创建警报。

有关更多信息，请参阅亚马逊 CloudWatch 用户指南中的使用亚马逊 CloudWatch 警报。