AmazonCloudWatchawsdocs.s3.amazonaws.com/AmazonCloudWatch/latest/acw-dev... · 2014-02-25 ·...

Amazon CloudWatch开发人员指南

API Version 2010-08-01

Amazon Web Services

Amazon CloudWatch 开发人员指南

Amazon CloudWatch: 开发人员指南Amazon Web ServicesCopyright © 2013 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

The following are trademarks or registered trademarks of Amazon: Amazon, Amazon.com, Amazon.comDesign, Amazon DevPay, Amazon EC2, Amazon Web Services Design, AWS, CloudFront, EC2, ElasticCompute Cloud, Kindle, and Mechanical Turk. In addition, Amazon.com graphics, logos, page headers,button icons, scripts, and service names are trademarks, or trade dress of Amazon in the U.S. and/or othercountries. Amazon's trademarks and trade dress may not be used in connection with any product or servicethat is not Amazon's, in any manner that is likely to cause confusion among customers, or in any mannerthat disparages or discredits Amazon.

All other trademarks not owned by Amazon are the property of their respective owners, who may or maynot be affiliated with, connected to, or sponsored by Amazon.


什么是 Amazon CloudWatch ................................................................................................................... 1Amazon CloudWatch 概念 ...................................................................................................................... 2支持的 AWS 服务 .................................................................................................................................... 8访问 Amazon CloudWatch ...................................................................................................................... 9地区和终端节点 ..................................................................................................................................... 10Amazon CloudWatch 定价 .................................................................................................................... 10Amazon CloudWatch 限制 .................................................................................................................... 10相关 AWS 服务 ...................................................................................................................................... 10Amazon CloudWatch 资源 .................................................................................................................... 11开始设置 ................................................................................................................................................ 12注册 Amazon Web Services (AWS) ...................................................................................................... 12登录 Amazon CloudWatch 控制台 ........................................................................................................ 12设置命令行界面 ..................................................................................................................................... 13Amazon CloudWatch 入门 .................................................................................................................... 18方案：将指标发布到 Amazon CloudWatch ........................................................................................... 18查看、绘制和发布指标 .......................................................................................................................... 22查看可用指标 ......................................................................................................................................... 22搜索可用指标 ......................................................................................................................................... 23选择和取消选择指标 .............................................................................................................................. 24获取指标的统计数据 .............................................................................................................................. 25

获取指定 EC2 实例的统计数据 .................................................................................................... 25聚合多实例统计数据 .................................................................................................................... 27通过 Auto Scaling 组获取聚合统计数据 ....................................................................................... 28通过映像 (AMI) ID 获取聚合统计数据 .......................................................................................... 30

绘制指标图表 ......................................................................................................................................... 31绘制指标图表 ............................................................................................................................... 32绘制跨资源指标的图表 ................................................................................................................. 32绘制多个指标的图表 .................................................................................................................... 33修改图表中的日期和时间 ............................................................................................................. 33修改图表的统计数据 .................................................................................................................... 33修改图表的周期 ............................................................................................................................ 34修改图表的标题 ............................................................................................................................ 34从图表上的指标创建警报 ............................................................................................................. 34放大图表 ...................................................................................................................................... 35在图表上将时间向后移 ................................................................................................................. 35在图表上将时间向前移 ................................................................................................................. 35在图表上跳转到“现在” .................................................................................................................. 36切换指标的 Y 轴 ........................................................................................................................... 36保存图表 ...................................................................................................................................... 36

发布自定义指标 ..................................................................................................................................... 37创建警报 ................................................................................................................................................ 39设置 Amazon Simple Notification Service ............................................................................................. 40创建警报 ................................................................................................................................................ 43根据 CPU 利用率警报发送电子邮件 ...................................................................................................... 43根据负载均衡器警报发送电子邮件 ........................................................................................................ 45根据存储吞吐量警报发送电子邮件 ........................................................................................................ 46创建停止或终止实例的警报 ................................................................................................................... 48Amazon EC2 实例的监控脚本 ............................................................................................................... 61用于 Linux 的 Amazon CloudWatch监控脚本 ........................................................................................ 61用于 Windows 的 Amazon CloudWatch 监控脚本 ................................................................................. 66控制用户访问您的 AWS 账户 ................................................................................................................ 75命名空间、维度和指标参考 ................................................................................................................... 79AWS 命名空间 ....................................................................................................................................... 79Auto Scaling 维度与指标 ....................................................................................................................... 80Amazon DynamoDB 维度与指标 ........................................................................................................... 82Amazon EBS 维度与指标 ...................................................................................................................... 87Amazon Elastic Compute Cloud 维度与指标 ........................................................................................ 88Elastic Load Balancing 维度与指标 ....................................................................................................... 91



Amazon Elastic MapReduce 维度与指标 .............................................................................................. 92Amazon RDS 维度与指标 ..................................................................................................................... 96Amazon Simple Notification Service 维度与指标 .................................................................................. 98Amazon SQS 维度与指标 ..................................................................................................................... 99AWS Storage Gateway 维度与指标 .................................................................................................... 100命令行界面参考 ................................................................................................................................... 104mon-cmd ............................................................................................................................................. 104mon-delete-alarms .............................................................................................................................. 106mon-describe-alarm-history ................................................................................................................ 110mon-describe-alarms .......................................................................................................................... 115mon-describe-alarms-for-metric .......................................................................................................... 120mon-disable-alarm-actions .................................................................................................................. 126mon-enable-alarm-actions .................................................................................................................. 130mon-get-stats ...................................................................................................................................... 134mon-list-metrics ................................................................................................................................... 142mon-put-data ....................................................................................................................................... 148mon-put-metric-alarm .......................................................................................................................... 154mon-set-alarm-state ............................................................................................................................ 162mon-version ........................................................................................................................................ 166创建 API 请求 ...................................................................................................................................... 170文档历史记录 ....................................................................................................................................... 177



什么是 Amazon CloudWatch

Amazon CloudWatch 可实时监控您的 Amazon Web Services (AWS) 资源以及您在 AWS 中运行的应用程序。您可以使用 Amazon CloudWatch 收集和跟踪指标，指标是您要衡量的相关资源和应用程序的变量。Amazon CloudWatch 警报可根据您定义的规则发送通知或者对您所监控的资源自动进行更改。例如，您可以监控您的 Amazon Elastic Compute Cloud (Amazon EC2) 实例的 CPU 利用率以及磁盘读写情况，然后使用此数据确定您是否应启动其他实例来处理增加的负载。您还可以使用此数据停止未完全利用的实例以节省开支。除了监控AWS附带的内置指标外，您还可以监控您自己的自定义指标。您可通过使用 Amazon CloudWatch 全面地了解资源使用率、应用程序性能和运行状况。

本节的其余部分介绍将有助于您了解使用AmazonCloudWatch监控您的资源和应用程序时所需执行的操作的主要概念和术语。

Topics• Amazon CloudWatch 架构 (p. 1)• Amazon CloudWatch 概念 (p. 2)• 支持的 AWS 服务 (p. 8)• 访问 Amazon CloudWatch (p. 9)• 地区和终端节点 (p. 10)• Amazon CloudWatch 定价 (p. 10)• Amazon CloudWatch 限制 (p. 10)• 相关 AWS 服务 (p. 10)• Amazon CloudWatch 资源 (p. 11)

使用CloudWatch进行设置部分介绍注册AWS以及设置AmazonCloudWatch命令行界面(CLI)的过程。CloudWatch 入门部分介绍发布指标、获取统计数据以及设置警报的过程。

Amazon CloudWatch 架构Amazon CloudWatch 基本上是一个指标存储库。AWS 产品—例如 Amazon EC2—会将指标放在存储库中，而您可以根据这些指标来检索统计数据。如果将自己的自定义指标放在存储库中，则还可以检索这些统计数据。


Amazon CloudWatch 开发人员指南Amazon CloudWatch 架构

您可以在AmazonCloudWatch控制台中使用指标计算统计数据并以图形化的方式显示数据。有关生成指标并将其发送到 Amazon CloudWatch 的其他 AWS 资源的更多信息，请参阅Amazon CloudWatch 命名空间、维度和指标参考 (p. 79)。

在满足特定条件时，您可以配置警报操作以停止、启动或终止 Amazon EC2 实例。此外，您还可以创建代表您启动 Auto Scaling 和 Amazon Simple Notification Service (Amazon SNS) 操作的警报。有关创建Amazon CloudWatch 警报的更多信息，请参阅警报 (p. 8)。

Amazon CloudWatch 概念下面介绍便于您了解和使用 Amazon CloudWatch 的核心术语和概念。

Topics• 指标 (p. 3)• 命名空间 (p. 3)• 维度 (p. 4)• 时间戳 (p. 5)• 单位 (p. 6)• 统计数据 (p. 6)• 时间段 (p. 7)• 聚合 (p. 7)• 警报 (p. 8)• 地区 (p. 8)


Amazon CloudWatch 开发人员指南Amazon CloudWatch 概念

指标指标是AmazonCloudWatch中的核心概念，代表了数据点的时间顺序集。这些数据点可以是您的自定义指标或者来自 AWS 中其他服务的指标。您或 AWS 产品可将指标数据点发布到 Amazon CloudWatch，并且您可以按一组有序的时间序列数据来检索关于这些数据点的统计数据。

可将指标视为要监控的变量，而数据点代表该变量随时间变化的值。例如，特定 Amazon EC2 实例的CPU 利用率是一个指标，而 Elastic Load Balancing 负载均衡器的延迟则是另一个指标。

数据点自身可以来自任何应用程序或业务活动，从其中您可以收集数据，而不只是AmazonWebServices产品和应用程序。例如，指标可能是特定 Amazon EC2 实例的 CPU 利用率或是制冷设备中的温度。

指标通过名称、命名空间以及一个或多个维度进行唯一定义。每个数据点都有一个时间戳和一个度量单位（可选）。当请求统计信息时，返回的数据流通过命名空间、指标名称、维度以及单位（可选）进行识别。

您可以使用 PutMetricData API 操作（或 mon-put-data命令）创建自定义指标并为其发布数据点。可以以您选择的任何顺序和任何速率添加数据点。当请求数据点的统计数据时，Amazon CloudWatch 会聚合完全相同的数据点（重复的值、时间戳和单位）。

Amazon CloudWatch 可将指标数据储存两个星期。可以从多种来源发布指标数据，例如从几十种不同Amazon EC2 实例的传入网络流量，或从几种不同Web应用程序的请求页面视图。可以请求指定时间范围内的指标数据点的统计信息。

相关主题

• PutMetricData (mon-put-data (p. 148))• ListMetrics (mon-list-metrics (p. 142))• GetMetricStatistics (mon-get-stats (p. 134))• 查看可用指标 (p. 22)

命名空间Amazon CloudWatch 命名空间是指标的容器。不同命名空间中的指标彼此独立，因此来自不同应用程序的指标不会被错误地聚合到相同的统计信息中。

命名空间名称是您在创建指标时定义的字符串。此类名称必须是有效的 XML 字符，通常包含字母数字字符"0-9A-Za-z"和"."（句点）、"-"（连字符）、"_"（下划线）、"/"（斜线）、"#"（井号）以及":"（冒号）。AWS 命名空间均遵循 AWS/< >协定，例如 AWS/EC2和 AWS/ELB。

Note

命名空间名称的长度不能超过 256 个字符。

无默认命名空间。必须为每个放置到 Amazon CloudWatch 中的数据元素指定命名空间。

相关主题

• AWS 命名空间 (p. 79)• 聚合多实例统计数据 (p. 27)


Amazon CloudWatch 开发人员指南指标

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListMetrics.html

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html

维度维度是帮助您对某指标进行唯一标识的名称/值对。每个指标包含用于描述该指标的特定特征，您可以将维度理解为这些特征的类别。维度可以帮助您设计统计数据计划的结构。因为维度是指标的唯一识别符的一部分，因此无论您在何时向一个指标添加唯一名称/值对，都会创建一个新的指标。

当您使用PutMetricData操作（或其等效命令行mon-put-data）创建指标时，可指定维度。向AmazonCloudWatch 提供数据的 AWS 中的服务还会向每个指标中附加维度。可以使用维度筛选 AmazonCloudWatch 查询返回的结果集。

例如，可以通过对特定AmazonEC2实例 ID调用包含 InstanceID维度集的 GetMetricStatistics，获取特定 Amazon EC2 实例的统计数据。

对于由特定服务（如Amazon EC2）生成的指标，Amazon CloudWatch 可以聚合多个维度中的数据。例如，如果对AWS/EC2命名空间中的某个指标调用GetMetricStatistics且不指定任何维度，AmazonCloudWatch 将聚合指定指标的所有数据以创建您请求的统计数据。但是，Amazon CloudWatch 不会为通过 PutMetricData或 mon-put-data创建的指标在多个维度中进行聚合。

Note

可以为一个指标分配最多 10 个维度。

在本部分末尾的图表中，调用 mon-put-data四次创建了四个不同的指标。如果只进行这四次调用，则可以对这四个维度组合进行统计数据检索：

• Server=Prod,Domain=Frankfurt

• Server=Prod,Domain=Rio

• Server=Beta,Domain=Frankfurt

• Server=Beta,Domain=Rio

您无法使用未曾专门创建的维度组合进行统计信息检索。例如，您无法检索下列任何维度组合的统计数据，除非创建新的指标以便通过额外调用 mon-put-data来指定这些组合：

• Server=Prod,Domain=<null>

• Server=<null>,Domain=Frankfurt

• Server=Beta,Domain=<null>

• Server=<null>,Domain=Rio

• Server=Prod

• Server=Beta

Important

Amazon CloudWatch 将维度的每种唯一组合视为一个单独的指标。例如，在下图中每次调用mon-put-data都会创建一个单独的指标，因为每次调用使用不同的维度集。即使全部四次调用使用相同的指标名称(ServerStats)，也是如此。要了解这种行为会对定价产生何种影响，请参阅 Amazon CloudWatch 产品信息页。


Amazon CloudWatch 开发人员指南维度

http://aws.amazon.com/cloudwatch/

相关主题

• mon-put-data (p. 148)• mon-get-stats (p. 134)• Amazon EC2 指标的维度 (p. 90)• Elastic Load Balancing 指标的维度 (p. 92)• RDS 指标的维度 (p. 97)

时间戳通过 Amazon CloudWatch，每个指标数据点必须带有一个时间戳标记。时间戳最长可以为过去的两周和将来的两小时。如果不提供时间戳，Amazon CloudWatch 会根据收到数据元素的时间创建一个时间戳。

在请求中使用的时间戳必须为 dateTime对象，并包含完整的日期及小时、分钟和秒。有关更多信息，请参阅 http://www.w3.org/TR/xmlschema-2/#dateTime。例如：2013-01-31T23:59:59Z.尽管没有强制要求，但还是建议您以协调世界时（UTC或格林威治标准时间）时区提供时间戳。在从AmazonCloudWatch中检索统计数据时，所有时间以 UTC 时区表示。


Amazon CloudWatch 开发人员指南时间戳

http://www.w3.org/TR/xmlschema-2/#dateTime

单位Units代表统计数据的度量单位。例如，AmazonEC2NetworkIn指标的单位是字节，因为NetworkIn会跟踪实例在所有网络界面上接收到的字节数。

还可以在创建自定义指标时指定单位。单位帮助为数据提供概念意义。指定度量单位的指标数据点（例如将会单独进行聚合。下方列表提供了一些 Amazon CloudWatch 支持的更常见的单位：

• Seconds

• Bytes

• Bits

• Percent

• Count

• Bytes/Second（每秒字节数）• Bits/Second（每秒比特数）• Count/Second（每秒计数次数）• None（无指定单位时的默认值）

有关 Amazon CloudWatch 支持的单位的完整列表，请参阅 Amazon CloudWatch API 参考中的MetricDatum 数据类型。

尽管在内部单位对于AmazonCloudWatch无重大意义，但其他应用程序可以根据您选择的单位获得语义信息。当您发布数据而不指定单位时，Amazon CloudWatch 会将其与 None单位关联。当您获取统计数据而不指定单位时，Amazon CloudWatch 会将相同单位的所有数据点聚合在一起。如果有两个完全相同的指标包含不同的单位，则每一个单位会各自返回一个数据流。

统计数据统计数据是指定时间段内的指标数据聚合。AmazonCloudWatch所提供的统计数据基于您的自定义数据提供给 Amazon CloudWatch 或者 AWS 中其他服务提供给该产品的指标数据点。聚合通过使用命名空间、指标名称、维度以及数据点度量单位在您指定的时间段内完成。下表介绍了可用的统计信息。

描述统计数据

指定时间段内的最低观察值。可以使用此值来决定应用程序的活动量是否较低。Minimum

指定时间段内的最高观察值。可以使用此值来决定应用程序的活动量是否较高。Maximum

为匹配指标所提交的所有的值添加在一起。此统计信息的作用是决定指标的总量。Sum

指定时间段内 Sum / SampleCount的值。通过将此统计数据与 Minimum和 Maximum进行比较，您可以确定指标的完整范围以及平均使用率与 Minimum和 Maximum的接近程度。这样的比较可以帮助了解何时应该根据需要增加或减少资源。

Average

数据点计数（数量）用于统计信息的计算。SampleCount

可以使用 GetMetricStatistics API 操作或 mon-get-stats命令检索统计数据，以便在创建指标值后指定用于命名空间、指标名称及维度参数的相同值。还可以指定AmazonCloudWatch将用于聚合的开始与结束时间。开始点和结束点彼此最近可为 60 秒，最远可为两星期。

Amazon CloudWatch允许您使用带 StatisticValues (statistic-values)参数的 PutMetricDataAPI操作（或mon-put-data命令）添加预先计算的统计数据。您可以指定SampleCount、Minimum、Maximum和 Sum的值（Amazon CloudWatch 会为您计算平均值），而不是数据点值。以这种方式添加的值会被与匹配指标关联的任何其他值聚合。


Amazon CloudWatch 开发人员指南单位

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html

相关主题

• PutMetricData (mon-put-data (p. 148))• GetMetricStatistics (mon-get-stats (p. 134))

时间段时间段是与特定AmazonCloudWatch统计数据关联的时间的长度。每项统计信息代表在指定时间段内对收集的指标数据的聚合。尽管时间段以秒表示，但是时间段的最小粒度为一分钟。相应地，您可以以 60的倍数指定时间段值。例如，要指定六分钟的时间段，应该使用值360。您可以通过改变时间段的长度来调整数据的聚合方式。时间段最短可以为一分钟（60 秒），最长可以为两星期（1,209,600 秒）。

调用 GetMetricStatistics时，可以通过 Period参数指定时间长度。两个相关参数（StartTime和 EndTime）决定了与统计数据关联的总时间长度。Period参数的默认值为 60 秒，而 StartTime和EndTime的默认值提供了最后一小时的统计数据。

您为 StartTime和 EndTime参数选择的值决定 GetMetricStatistics将返回的时间段的数量。例如，使用 Period、EndTime和 StartTime参数的默认值调用 GetMetricStatistics，会返回前一小时内每分钟的统计数据聚合集。如果要按 10 分钟的间隔聚合统计数据，可将 Period设为 600。对于一个完整小时内聚合的统计数据，应使用 Period值 3600。

时间段同样是AmazonCloudWatch警报功能的重要组成部分。当您创建警报以监控特定指标时，您是在要求Amazon CloudWatch 将该指标与您提供的阈值进行比较。您可以对Amazon CloudWatch 如何进行此比较进行充分控制。不只能指定进行比较的时间段，还可以指定阈值必须打破多少个连续时间段后向您发送通知。有关警报的更多信息，请参阅警报 (p. 8)。

聚合Amazon CloudWatch 会根据您在调用 GetMetricStatistics时指定的时间段长度对统计数据进行聚合。您可以根据需要发布包含相同或类似时间戳的任意数量的数据点。Amazon CloudWatch 会在您通过GetMetricStatistics获得这些数据点的统计数据时根据时间段长度对其进行聚合。仅在使用详细监控时才能聚合统计数据。此外，Amazon CloudWatch 不跨各个地区聚合数据。

可以为共享相同时间戳、相同命名空间和维度的指标发布数据点。对 GetMetricStatistics的后续调用将返回关于这些数据点的聚合统计数据。您甚至可以通过一个 PutMetricData请求完成这项操作。Amazon CloudWatch可以在同一 PutMetricData调用中接受包含相同时间戳的多个数据点。还可以为包含任意时间戳的相同或不同指标发布多个数据点。但是，PutMetricData请求的大小限制为8KB（对于 HTTP GET 请求）和 40 KB（对于 HTTP POST 请求）。一个 PutMetricData请求中最多可以包含20 个数据点。

对于可能导致 PutMetricData失效的大数据集，Amazon CloudWatch 允许插入称为 StatisticSet 的预先聚合的数据集。通过 StatisticSets，可以为 Amazon CloudWatch 提供大量数据点的 Min、Max、Sum和SampleCount。当您需要在一分钟内多次收集数据时，通常可以使用StatisticSets。例如，假设您拥有一个关于网页请求延迟的指标。对每次网页点击操作都执行 PutMetricData请求毫无意义。建议您收集指向该网页的所有点击操作的延迟，每一分钟对其聚合一次，然后将 StatisticSet 发送到 AmazonCloudWatch。

Amazon CloudWatch 不区分指标的来源。如果从不同的来源发布包含相同命名空间和维度的某个指标，则AmazonCloudWatch会将其视为一个单独的指标。这对分布式扩展型系统中的服务指标有其作用。例如，Web 服务器应用程序中的所有主机可以发布完全相同的指标，这些指标代表您正在处理的请求的延迟。Amazon CloudWatch 会将这些指标视为一个单独的指标，以便允许您获取应用程序中所有请求的最小值、最大值、平均值及总和的统计数据。


Amazon CloudWatch 开发人员指南时间段



警报警报可以根据您指定的参数自动为您发起操作。警报按指定的时间段监控单个指标，并根据相对于给定阈值的指标值每隔若干个时间段执行一项或多项操作。该操作是一个发送到 Amazon Simple NotificationService (Amazon SNS) 主题或 Auto Scaling 策略的通知。警报仅在出现持续状态变化时才会调用操作。Amazon CloudWatch 警报将不会仅因为其处于特定状态而调用操作，该状态必须已改变并在指定的若干个时间段内保持不变。

创建警报时，应选择与待监控指标的频率相等或更高的时间段。例如，对 Amazon EC2 实例进行的基本监控每5分钟提供一次指标。当为基本监控指标设置警报时，选择的时间段至少应为300秒（5分钟）。对 Amazon EC2 实例进行的详细监控每 1 分钟提供一次指标。当为详细监控指标设置警报时，选择的时间段至少应为 60 秒（1 分钟）。

相关主题

• PutMetricAlarm

• mon-put-metric-alarm (p. 154)• 创建 Amazon CloudWatch 警报 (p. 39)

有关演示如何设置可调用 Auto Scaling 策略及 Amazon SNS 主题的 Amazon CloudWatch 警报的示例，请参阅创建 Amazon CloudWatch 警报 (p. 39)。

地区Amazon云计算资源存储在具有高度可用性的数据中心设施中。要提供额外的可扩展性和可靠性，每个数据中心设施应位于称为地区的特定地理区域。地区是指大型、分布范围广泛的地理位置。

每个 Amazon 地区均被设计为与其它 Amazon 地区完全隔离。这种设计将实现最大程度的故障隔离和稳定性，并可以明确每个Amazon资源所在的位置。Amazon CloudWatch不跨各个地区聚合数据。因此指标在各地区间彼此独立。

有关代表每个地区的终端节点的更多信息，请参阅 Amazon Web Services 一般参考中的地区和终端节点。

支持的 AWS 服务Amazon CloudWatch 可监控以下服务。一旦您开始使用某服务，它会自动向 Amazon CloudWatch 发送指标。

Amazon CloudWatch 为支持的 AWS 产品提供基本监控或详细监控。基本监控是一项每隔 5 分钟向Amazon CloudWatch 发送数据点的服务。详细监控是一项每分钟向 Amazon CloudWatch 发送数据点的服务。

Note

如果您使用的服务支持基本和详细数据收集功能（例如Amazon EC2和Auto Scaling），并且您想访问详细统计数据，则必须对该项服务启用详细指标收集功能。

• Auto Scaling

Auto Scaling 包含 7 个指标和 1 个维度，并且默认每 5 分钟向 Amazon CloudWatch 发送一次数据。支付额外费用，即可对 Auto Scaling 启用详细监控，以便每分钟向 Amazon CloudWatch 发送一次数


Amazon CloudWatch 开发人员指南警报

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html

http://docs.aws.amazon.com/general/latest/gr/index.html?rande.html


据。您可以使用 Auto Scaling 维度与指标 (p. 80) 创建警报。有关更多信息，请参阅 Auto Scaling 开发人员指南中的监控 Auto Scaling 实例。

• Amazon DynamoDB

AmazonDynamoDB包含9个指标和2个维度，并且每5分钟向AmazonCloudWatch发送一次数据。您可以使用 Amazon DynamoDB 维度与指标 (p. 82) 创建警报。有关更多信息，请参阅 AmazonDynamoDB 开发人员指南中的使用 Amazon CloudWatch监控 Amazon DynamoDB 表。

• Amazon Elastic Block Store

Amazon Elastic Block Store 包含 10 个指标和 1 个维度，并且每 5 分钟向 Amazon CloudWatch 发送一次数据。您可以使用 Amazon EBS 维度与指标 (p. 87) 创建警报。有关更多信息，请参阅 AmazonElastic Compute Cloud 用户指南中的监控您的卷状态。

• Amazon Elastic Compute Cloud

Amazon EC2 包含 10个指标和 4个维度，并且默认情况下每 5分钟向 Amazon CloudWatch 发送一次数据。支付额外费用，即可为 Amazon EC2 启用详细监控，以便每分钟向 Amazon CloudWatch 发送一次数据。您可以使用Amazon Elastic Compute Cloud维度与指标 (p. 88) 创建警报。有关更多信息，请参阅 Amazon Elastic Compute Cloud 用户指南中的监控您的实例。

• Elastic Load Balancing

Elastic Load Balancing 包含 10 个指标和 2 个维度，并且每分钟向 Amazon CloudWatch 发送一次数据。您可以使用 Elastic Load Balancing 维度与指标 (p. 91) 创建警报。有关更多信息，请参阅 ElasticLoad Balancing 开发人员指南中的使用 Amazon CloudWatch 监控您的负载均衡器。

• Amazon Elastic MapReduce

Amazon Elastic MapReduce 包含 26 个指标和 2 个维度，并且每 5 分钟向 Amazon CloudWatch 发送一次数据。您可以使用 Amazon Elastic MapReduce 维度与指标 (p. 92) 创建警报。有关更多信息，请参阅 Amazon Elastic MapReduce 开发人员指南中的使用 Amazon CloudWatch 监控指标。

• Amazon Relational Database Service

Amazon Relational Database Service包含 14个指标和3个维度，并且每分钟向Amazon CloudWatch发送一次数据。您可以使用AmazonRDS维度与指标(p. 96)创建警报。有关更多信息，请参阅AmazonRelational Database Service 用户指南中的监控数据库实例。

• Amazon Simple Notification Service

Amazon Simple Notification Service 包含 4个指标和 1个维度，并且每 5分钟向Amazon CloudWatch发送一次数据。您可以使用 Amazon Simple Notification Service 维度与指标 (p. 98) 创建警报。有关更多信息，请参阅 Amazon Simple Notification Service 开发人员指南中的使用 Amazon CloudWatch监控 Amazon SNS。

• Amazon Simple Queue Service

Amazon Simple Queue Service 包含 8 个指标和 1 个维度，并且每 5 分钟向 Amazon CloudWatch 发送一次数据。您可以使用Amazon SQS维度与指标 (p. 99) 创建警报。有关更多信息，请参阅AmazonSimple Queue Service 开发人员指南中的使用 Amazon CloudWatch 监控 Amazon SQS。

• AWS Storage Gateway

AWS Storage Gateway 包含 11 个指标和 3 个维度，并且每 5 分钟向 Amazon CloudWatch 发送一次数据。您可以使用AWSStorageGateway维度与指标(p. 100)创建警报。有关更多信息，请参阅AWSStorage Gateway 用户指南中的监控 AWS Storage Gateway。

访问 Amazon CloudWatch您可以使用下面任何方式访问 Amazon CloudWatch：

• Amazon CloudWatch 控制台


Amazon CloudWatch 开发人员指南访问 Amazon CloudWatch

http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-instance-monitoring.html

http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/MonitoringDynamoDB.html

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-volume-status.html

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-monitoring.html

http://docs.aws.amazon.com/ElasticLoadBalancing/latest/DeveloperGuide/US_MonitoringLoadBalancerWithCW.html

http://docs.aws.amazon.com/ElasticMapReduce/latest/DeveloperGuide/UsingEMR_ViewingMetrics.html

http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Monitoring.html

http://docs.aws.amazon.com/sns/latest/dg/MonitorSNSwithCloudWatch.html


http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/MonitorSQSwithCloudWatch.html

http://docs.aws.amazon.com/storagegateway/latest/userguide/GatewayMetrics.html

有关 Amazon CloudWatch 控制台的更多信息，请参阅登录 Amazon CloudWatch 控制台 (p. 12)。• 面向 Android 和 iOS 的 AWS 控制台

有关 AWS 控制台的更多信息，请参阅面向 Android 和 iOS 的 AWS 控制台。• Amazon CloudWatch CLI

有关 Amazon CloudWatch CLI 的更多信息，请参阅 Amazon CloudWatch 命令行界面参考 (p. 104)。• Amazon CloudWatch API

有关 Amazon CloudWatch API 的更多信息，请参阅 Amazon CloudWatch API 参考。

地区和终端节点您可以在特定的 AWS地区监控指标和创建警报。可将您的 Amazon CloudWatch 请求发送到特定于地区的终端节点。有关支持的 AWS 地区的列表，请参阅 Amazon Web Services 一般参考中的地区和终端节点。

Amazon CloudWatch 定价您可为每个客户每月免费获取 10 个 Amazon CloudWatch 指标、10 个警报、1000000 个 API 请求和1000 个 Amazon SNS电子邮件通知。任何额外警报或电子邮件通知根据标准AWS费率收取费用。有关更多信息，请参阅 Amazon CloudWatch 定价和 Amazon SNS 定价。在注册 Amazon CloudWatch 后，您无法取消注册，但可以删除所创建的任何警报或指标。

Amazon CloudWatch 限制Amazon CloudWatch 有以下限制：

• 您可为每个客户每月免费获取 10 个 Amazon CloudWatch 指标、10 个警报、1000000 个 API 请求和1000 个 Amazon SNS 电子邮件通知。

• 您最多只能为每个指标分配 10 个维度。• 每个 AWS 账户可以创建最多 5000 个警报。• 指标数据将保存 2 周。• PutMetricData请求的大小限制为8KB（对于HTTPGET请求）和40KB（对于HTTPPOST请求）。• 您最多可以在一个PutMetricData 请求中包含 20个MetricDatum项目。一个MetricDatum可以包含一个值或代表多个值的一个 StatisticSet。

相关 AWS 服务以下服务可与 Amazon CloudWatch 一起使用：

• Auto Scaling 是一项Web 服务，使您能够根据用户定义的策略、运行状况检查和时间表自动启动或终止 Amazon Elastic Compute Cloud (Amazon EC2) 实例。可将 Amazon CloudWatch 警报与 AutoScaling 一起使用以根据需求扩展 Amazon EC2 实例。有关更多信息，请参阅 Auto Scaling 开发人员指南中的根据需求进行扩展。

• Amazon Simple Notification Service (Amazon SNS) 是一项Web 服务，用于协调和管理向订阅终端节点或客户交付或发送消息的过程。可结合使用 Amazon SNS 与 Amazon CloudWatch 以便在达到警报阈值时发送消息。有关更多信息，请参阅设置 Amazon Simple Notification Service (p. 40)。


Amazon CloudWatch 开发人员指南地区和终端节点

http://aws.amazon.com/console/mobile/

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/Welcome.html



http://aws.amazon.com/pricing/cloudwatch/

http://aws.amazon.com/pricing/sns/

http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-scale-based-on-demand.html

Amazon CloudWatch 资源下表列出了在您使用 Amazon CloudWatch 时可提供帮助的相关资源。

描述资源

常见问题涵盖了开发人员对此产品提出的20个最热门问题。AmazonCloudWatch技术方面常见问题

本发行说明简要概括了当前的发行版本。特别说明了一些新功能、修复和已知问题。

发行说明

这是一个帮助您入门的资源整合点，您可以在这里找到相关的文档、代码示例、发行说明和其他信息，帮助您通过AWS构建创新的应用程序。

AWS 开发人员资源中心

此控制台让您无需进行编程，即可执行Amazon CloudWatch和其他各种 AWS 产品的大部分功能。

AWS 管理控制台

由开发人员组成的社区形式的论坛，开发人员可在这里讨论与Amazon CloudWatch 有关的技术问题。

Amazon CloudWatch 开发论坛

AWS 技术支持的首页包括对我们的开发人员论坛、技术FAQ、服务状态和高级支持等页面。

AWS 支持中心

提供有关 AWS Premium Support 信息的主要Web 页面，它是一种一对一、快速响应的支持渠道，可帮助您在AWS基础设施服务上构建和运行应用程序。

AWS Premium Support

提供 Amazon CloudWatch 相关信息的主要Web 页面。Amazon CloudWatch 产品信息

这是一个有关查询的中心联络点，可帮助您查询有关AWS计费、AWS 账户、事件和滥用等方面的信息

联系我们


Amazon CloudWatch 开发人员指南Amazon CloudWatch 资源

http://aws.amazon.com/ec2/faqs/

http://aws.amazon.com/releasenotes/CloudWatch

http://aws.amazon.com

http://aws.amazon.com/console/

https://forums.aws.amazon.com/forum.jspa?forumID=138

http://aws.amazon.com/support

http://aws.amazon.com/premiumsupport

http://aws.amazon.com/cloudwatch/

http://aws.amazon.com/contact-us/

开始设置

要使用 Amazon CloudWatch，您需要 AWS 账户使用服务（例如 Amazon EC2）生成可在 AmazonCloudWatch控制台（一种基于Web的点击式界面）中查看的指标。此外，您还需要安装并配置AmazonCloudWatch 命令行界面 (CLI)。

Topics• 注册 Amazon Web Services (AWS) (p. 12)• 登录 Amazon CloudWatch 控制台 (p. 12)• 设置命令行界面 (p. 13)

注册 Amazon Web Services (AWS)创建 AWS 账户时，我们会自动为所有 AWS 服务注册您的账户。您只需为使用的服务付费。

如果您已有一个 AWS 账户，请跳到下一个步骤。如果您还没有 AWS 账户，请使用以下步骤创建。

如需注册 AWS 账户

1. 转到 http://aws.amazon.com，然后单击注册。2. 按照屏幕上的说明进行操作。

作为注册流程的一部分，您会收到一个电话，需要您使用电话键盘输入一个 PIN 码。

登录 Amazon CloudWatch 控制台登录 Amazon CloudWatch 控制台的步骤

• 登录 AWS 管理控制台，并通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。

监控仪表板打开。您的仪表板看起来可能类似于：


Amazon CloudWatch 开发人员指南注册 Amazon Web Services (AWS)

http://aws.amazon.com

https://console.aws.amazon.com/cloudwatch/

如果您没有任何警报，则您的警报部分将显示创建警报按钮。即使是您首次使用AmazonCloudWatch控制台，您的指标部分也可能已经报告您使用了大量指标，这是因为一些AWS产品会自动将免费指标推送到 Amazon CloudWatch。

设置命令行界面必须先安装并配置 Amazon CloudWatch 命令行界面 (CLI)，然后才能使用它。

Note

作为惯例，命令行文本以通用的 PROMPT> 命令行提示符作为前缀。您的计算机上的命令行通配符可能有所不同。我们还使用 $ 表示Linux/UNIX特定命令，使用 C:\> 表示Windows特定命令。尽管我们不提供详细说明，但是 CLI 还可以在Mac OS X 上正常使用（与 Linux 和 UNIX 命令类似）。此命令产生的示例输出随后会立即显示，并且不带任何前缀。

Topics• 步骤 1：安装 CLI (p. 13)• 步骤 2：为您的证书配置 CLI (p. 15)• 步骤 3：设置地区 (p. 16)• 步骤 4：测试 CLI 配置 (p. 16)

步骤 1：安装 CLICLI 以 Java 语言书写，包含所有Windows 和 Linux/UNIX/Mac OSX 的外壳脚本。

安装 Amazon CloudWatch CLI 的步骤

1. 从 Amazon CloudWatch 工具中下载 CLI。2. 将 Amazon CloudWatch 存档保存并解包到您的工作站中的方便位置。


Amazon CloudWatch 开发人员指南设置命令行界面

http://developer.amazonwebservices.com/connect/entry.jspa?externalID=2534

3. 输入命令 java -version，确定在您的工作站上安装的 Java 版本。如果未安装 1.5 版本或更新版本，请从 http://www.java.com 下载并安装更新的版本。

4. 设置 JAVA_HOME环境变量，使其指向您的 Java 安装。

Note

如果您使用的是 Cygwin，则必须为 AWS_CLOUDWATCH_HOME和 AWS_CREDENTIAL_FILE使用 Linux/UNIX 路径（例如 /usr/bin 而不是 C:\usr\bin）。不过，JAVA_HOME应该有一个Windows 路径。另外，即使该值带引号或空格被转义，也不能包含任何空格。

• 以下 Linux/UNIX 示例演示如何为 /usr/local/jre/bin目录中的 Java 可执行文件设置JAVA_HOME。

$ export JAVA_HOME=/usr/local/jre

• 以下 Windows 示例演示如何使用 set 和 setx 命令为 C:\java\jdk1.6.0_6\bin目录中的 Java可执行文件设置 JAVA_HOME。set 命令定义当前会话的 JAVA_HOME，而 setx 使更改成为永久更改。

C:\> set JAVA_HOME=C:\java\jdk1.6.0_6C:\> setx JAVA_HOME C:\java\jdk1.6.0_6

Note

请勿在 JAVA_HOME中包括 bin 目录，否则 CLI 将无法使用。

5. 在使用其他 Java 版本之前将您的 Java 目录添加到路径中。

• 在 Linux 和 UNIX 中，您可以按以下方式更新您的 PATH：

$ export PATH=$PATH:$JAVA_HOME/bin

Note

export命令仅适用于当前的 Shell 会话。要永久创建或更新环境变量，请将此命令包括在启动脚本中。例如，如果您使用 Bash Shell，可以将命令包含在您的 ~/.bashrc或/etc/profile文件中。

• 在 Windows 中，语法稍有不同：

C:\> set PATH=%PATH%;%JAVA_HOME%\bin

Note

当您关闭命令窗口时，Windows 环境变量会重置。建议您使用 setx命令进行永久性设置。


Amazon CloudWatch 开发人员指南步骤 1：安装 CLI

http://www.java.com

6. 使用命令 $JAVA_HOME/bin/java -version验证您的 JAVA_HOME设置。

$ $JAVA_HOME/bin/java -versionjava version "1.6.0_33"Java(TM) SE Runtime Environment (build 1.6.0_33-b03)Java HotSpot(TM) Client VM (build 20.8-b03, mixed mode, sharing)

Windows 中的语法有所差异，但输出内容是相似的。

C:\> %JAVA_HOME%\bin\java -versionjava version "1.6.0_33"Java(TM) SE Runtime Environment (build 1.6.0_33-b03)Java HotSpot(TM) Client VM (build 20.8-b03, mixed mode, sharing)

7. CLI 依靠环境变量 (AWS_CLOUDWATCH_HOME) 来定位支持库。您需要将此环境变量设置为 AmazonCloudWatch 存档解包的位置。

• 在 Linux 和 UNIX 中，您可以按如下方式设置该环境变量：

$ export AWS_CLOUDWATCH_HOME=<path-to-tools>


C:\> set AWS_CLOUDWATCH_HOME=<path-to-tools>

8. 将 CLI bin目录添加到您的系统 PATH环境变量中。

• 在 Linux 和 UNIX 中，您可以按以下方式更新您的 PATH：

$ export PATH=$PATH:$AWS_CLOUDWATCH_HOME/bin


C:\> set PATH=%PATH%;%AWS_CLOUDWATCH_HOME%\binC:\> setx PATH %PATH%;%AWS_CLOUDWATCH_HOME%\bin

步骤 2：为您的证书配置 CLI必须提供AWS证书才能使用Amazon CloudWatch CLI。有两种类型的访问密钥：访问密钥 ID和私有访问密钥。在您创建访问密钥时，您应该已经将它们存放在安全的位置。虽然您可以从您的安全凭证页面中检索访问密钥 ID，但是您无法检索私有访问密钥。因此，如果找不到您的私有访问密钥，您需要创建新的访问密钥，然后才能使用 CLI 工具。

您可以在每次发布命令时通过--aws-credential-file参数指定您的证书，也可以创建一个指向您的本地系统中的证书文件的环境变量。如果该环境变量配置正确，您可以在发布命令时省略--aws-credential-file参数。以下过程介绍如何创建证书文件和相应的 AWS_CREDENTIAL_FILE环境变量。


Amazon CloudWatch 开发人员指南步骤 2：为您的证书配置 CLI

https://console.aws.amazon.com/iam/home?#security_credential

为 CLI 设置安全证书的步骤

1. 将您的访问密钥ID和私有访问密钥添加到名为credential-file-path.template的文件，该文件位于您安装 Amazon CloudWatch CLI 的文件夹。

2. 重命名该文件并将其保存到您的工作站中方便的位置。

• 如果您使用 Linux 或 UNIX，请按如下方式设置文件权限：

$ chmod 600 <credential file name>

• 在 Windows 中，您无需更改文件权限。

3. 将 AWS_CREDENTIAL_FILE 环境变量设置到您刚刚创建的证书文件完全限定的路径。

• 在 Linux 和 UNIX 中，您可以按如下方式设置该环境变量：

$ export AWS_CREDENTIAL_FILE=<path-to-file>

• 在 Windows 上，您可以按以下方式设置此环境变量：

C:\> set AWS_CREDENTIAL_FILE=<path-to-file>

步骤 3：设置地区此过程介绍如何通过更改服务终端节点 URL 来指定不同的地区。

如需指定其他地区

1. 要查看可用地区，请参阅 Amazon Web Services 一般参考中的地区和终端节点。2. 要更改服务终端节点，请设置 AWS_CLOUDWATCH_URL环境变量。

• 以下 Linux/UNIX 示例将 AWS_CLOUDWATCH_URL设置为 .

$ export AWS_CLOUDWATCH_URL=

• 以下 Windows 示例将 AWS_CLOUDWATCH_URL设置为 .

C:\> set AWS_CLOUDWATCH_URL=C:\> setx AWS_CLOUDWATCH_URL=

步骤 4：测试 CLI 配置在安装并配置 Amazon CloudWatch CLI 后，应测试您的配置。


Amazon CloudWatch 开发人员指南步骤 3：设置地区

http://docs.aws.amazon.com/general/latest/gr/rande.html#cw_region

测试您的 CLI 安装和配置的步骤

1. 在工作站中，打开新的命令提示符。2. 键入命令 mon-cmd。

您应该可以看到类似于如下所示的输出内容：

Command Name Description

------------ ----------- mon-delete-alarms Delete alarms mon-describe-alarm-history Describe alarm history mon-describe-alarms Describe alarms fully. mon-describe-alarms-for-metric Describe all alarms ... a single metricmon-disable-alarm-actions Disable all actions for a given alarmmon-enable-alarm-actions Enable all actions for a given alarmmon-get-stats Get metric statistics mon-list-metrics List user's metrics mon-put-data Put metric data mon-put-metric-alarm Create new alarm or update existing onemon-set-alarm-state Manually set the state of an alarmmon-version Prints the version ... tool and the API

For help on a specific command, type '<commandname> --help'

现在您已完成了 Amazon CloudWatch CLI 的安装和配置过程。


Amazon CloudWatch 开发人员指南步骤 4：测试 CLI 配置

Amazon CloudWatch 入门

方案：将指标发布到 Amazon CloudWatch您现在已安装了 Amazon CloudWatch CLI，可随时向 Amazon CloudWatch 发布指标。在此场景中，您将使用CLI为名为GetStarted的假想应用程序发布单个指标。然后，您将需要使用AmazonCloudWatch控制台查看这些指标的统计信息图表。

Topics• 步骤 1：定义数据配置 (p. 18)• 步骤 2：将指标添加到 Amazon CloudWatch (p. 19)• 步骤 3：从 Amazon CloudWatch 获得统计数据 (p. 20)• 步骤 4：使用控制台查看图表 (p. 20)

步骤 1：定义数据配置在此场景中，您将发布跟踪该应用程序的请求延迟的数据点。为您的指标和命名空间选择您能够理解的名称。对本例而言，请将指标命名为 RequestLatency 并将所有数据点置于 GetStarted 命名空间中。

您将会发布共表示三小时延迟数据的几个数据点。原始数据由分布在三小时中的十五个请求延迟读数构成。每个读数均以毫秒为单位：

• 第一小时：87, 51, 125, 235• 第二小时：121, 113, 189, 65, 89• 第三小时：100, 47, 133, 98, 100, 328

您可以将数据作为单个数据点或整合数据点集（称为统计数据集）发布到 Amazon CloudWatch。您将会把来自第一小时的数据点作为单一数据点发布。

原始数据小时

871

511

1251


Amazon CloudWatch 开发人员指南方案：将指标发布到 Amazon CloudWatch

原始数据小时

2351

对于第二小时和第三小时的数据，您将会整合数据点并发布各小时的统计数据集。

Note

您可以在低达一分钟的时间内将指标整合到粒度级。

您可以将整合数据点作为一个包含以下四个预定义项的统计数据集发布到 Amazon CloudWatch：Sum、Minimum、Maximum和 SampleCount。项值如下表所示。

样本数最大值最小值总计原始数据小时

518965577121, 113, 189, 65, 892

632847806100, 47, 133, 98, 100, 3283

步骤 2：将指标添加到 Amazon CloudWatch定义数据配置后，您可以随时开始添加数据。

Note

使用 mon-put-data命令时，必须使用过去两个星期内的日期范围。目前尚无删除数据点的功能。Amazon CloudWatch 会自动删除 timestamp超过两个星期的数据点。

mon-put-data命令包含若干个缩写形式的参数，便于快速输入数据。下表包含相关 mon-put-data参数的缩写形式。您可以使用这些缩写形式简化数据输入。

缩写形式参数

-m--metric-name

-n--namespace

-t--timestamp

-s--statisticValues

-u--unit

-v--value

将数据点发布到 Amazon CloudWatch 的步骤

1. 打开命令提示符并输入如下数据，但是要将时间戳替换为通用协调时间 (UTC) 中过去两小时的时间戳。

mon-put-data -m RequestLatency -n "GetStarted" -t 2013-07-23T20:30:00Z -v 87 -u Millisecondsmon-put-data -m RequestLatency -n "GetStarted" -t 2013-07-23T20:30:00Z -v


Amazon CloudWatch 开发人员指南步骤 2：将指标添加到 Amazon CloudWatch

51 -u Millisecondsmon-put-data -m RequestLatency -n "GetStarted" -t 2013-07-23T20:30:00Z -v 125 -u Millisecondsmon-put-data -m RequestLatency -n "GetStarted" -t 2013-07-23T20:30:00Z -v 235 -u Milliseconds

Amazon CloudWatch 仅在其无法执行命令时返回响应。2. 输入第二个数据点，但该时间使用晚于通用协调时间 (UTC) 中第一个时间戳一小时的时间戳。

mon-put-data -m RequestLatency -n "GetStarted" -t 2013-07-23T21:30:00Z -s "Sum=577,Minimum=65,Maximum=189,SampleCount=5" -u Milliseconds

3. 输入最后的数据点，但是该时间忽略时间戳以获得当前时间（默认值）。

mon-put-data -m RequestLatency -n "GetStarted" -s "Sum=806,Minimum=47,Maxim um=328,SampleCount=6" -u Milliseconds

mon-put-data命令还包含许多其他选项。有关更多信息，请参阅 Amazon CloudWatch 开发人员指南中的 mon-put-data。

添加指标后，您就可以获得统计数据。

步骤 3：从 Amazon CloudWatch 获得统计数据您现在已向 Amazon CloudWatch 发布了指标，可随时检索基于这些指标的统计数据。在以下每个示例中，只有 --metric-name、--namespace和 --statistics是必需参数。

如需借助命令行工具检索统计数据

• 为 --start-time指定足够久的过去时间，以涵盖您发布的最早时间戳。您可以忽略 --end-time参数，因为它默认为当前时间。--headers参数提供表头。

mon-get-stats -n GetStarted -m RequestLatency -s "Average" --start-time 2013-07-23T00:00:00Z --headers

Amazon CloudWatch 将返回以下内容：

Time Average Unit2013-07-19 20:30:00 124.5 Milliseconds2013-07-19 21:30:00 115.4 Milliseconds2013-07-19 22:17:00 134.33333333333334 Milliseconds

要以可视格式查看统计数据，可以使用 Amazon CloudWatch 控制台查看图表。

步骤 4：使用控制台查看图表将指标发布到 Amazon CloudWatch 后，您可以使用 Amazon CloudWatch 控制台查看统计图表。


Amazon CloudWatch 开发人员指南步骤 3：从 Amazon CloudWatch 获得统计数据

http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/cli-mon-put-data.html

如需在控制台中查看统计数据图表

1. 登录 AWS 管理控制台，并通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。

2. 如果需要，可以更改地区。从导航栏中，选择符合需要的地区。有关更多信息，请参阅地区和终端节点。

3. 在导航窗格中，单击指标。按类别显示的 CloudWatch 指标在右窗格中打开。4. 在按类别显示的 CloudWatch 指标窗格中，在搜索框内输入 RequestLatency。5. 选中 RequestLatency 指标名称旁的复选框。在下方窗格中会显示一个指标数据图表。6. 要更改此图表，请从位于图表名称旁的统计数据和周期列表中选择不同的值。7. 要为此指标创建警报，在工具下，单击创建警报。

恭喜您！您已成功发布并查看了自定义指标。


Amazon CloudWatch 开发人员指南步骤 4：使用控制台查看图表


http://docs.aws.amazon.com/general/latest/gr/rande.html

http://docs.aws.amazon.com/general/latest/gr/rande.html

查看、绘制和发布指标

指标是关于您的系统性能的数据。默认情况下，会为 Amazon EC2 实例、Amazon EBS 卷、AmazonRDS 数据库实例和 Elastic Load Balancing 提供一组免费的指标。您也可以选择对您的 Amazon EC2 实例启用详细监控，或者添加您自己的应用程序指标。指标数据的保留期限为两周，使您能够查看最新数据及历史数据。Amazon CloudWatch 可加载您账户中的所有指标，从而使您能够使用 AWS 管理控制台进行搜索、绘制图表及设置警报。这些指标包括您提供的 AWS 资源指标和应用程序指标。

您可以使用下列步骤在AmazonCloudWatch中绘制指标图表。如果您已经完成了这些步骤，就可以为指标创建警报。有关更多信息，请参阅创建 Amazon CloudWatch 警报 (p. 39)。

Topics• 查看可用指标 (p. 22)• 搜索可用指标 (p. 23)• 选择和取消选择指标 (p. 24)• 获取指标的统计数据 (p. 25)• 绘制指标图表 (p. 31)• 发布自定义指标 (p. 37)

查看可用指标只有AWS中您所使用的那些服务会将指标发送到AmazonCloudWatch。您可以使用AmazonCloudWatch控制台、mon-list-metrics命令或者 ListMetrics API 来查看可用指标。

AWS 管理控制台按类别查看可用指标

您可以按类别查看指标。指标首先按命名空间进行分组，然后按各命名空间内的各种维度组合进行分组。例如，您可以查看所有 EC2 指标或按实例 ID、实例类型、映像 (AMI) ID 或 Auto Scaling 组分组的 EC2指标。

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。


Amazon CloudWatch 开发人员指南查看可用指标


3. 在按类别显示的CloudWatch指标窗格中的EC2指标下，选择每个实例的指标，然后在上方窗格中，向下滚动以查看完整的指标列表。

命令行工具列出多个 Amazon EC2 实例中的可用指标

• 输入 mon-list-metrics命令。添加 --headers参数以显示列标题。

Prompt>mon-list-metrics --headers

Amazon CloudWatch 将返回以下内容（部分列表）：

Metric Name Namespace DimensionsCPUUtilization AWS/EC2 {InstanceId=i-5431413d}CPUUtilization AWS/EC2 {InstanceId=i-d43242bd}CPUUtilization AWS/EC2 {InstanceId=i-1d3d4d74}CPUUtilization AWS/EC2 {InstanceId=i-78314111}CPUUtilization AWS/EC2 {InstanceId=i-d3c8baba}CPUUtilization AWS/EC2 {InstanceId=i-0d334364}CPUUtilization AWS/EC2 {InstanceId=i-6732420e} CPUUtilization AWS/EC2 {InstanceId=i-d93141b0}CPUUtilization AWS/EC2 {InstanceId=i-e03d4d89}CPUUtilization AWS/EC2 {InstanceId=i-c93d4da0}CPUUtilization AWS/EC2 {InstanceId=i-e0304089}CPUUtilization AWS/EC2 {InstanceId=i-e1304088}CPUUtilization AWS/EC2 {InstanceId=i-69334300}

查询 API要确定多个实例中的可用指标，请执行以下步骤：

• 调用 ListMetrics 以生成一份包含所有有效指标的列表。

这会返回一份指标列表。指标的示例可能类似于：

• MetricName =CPUUtilization• Dimensions (Name=InstanceId, Value=i-5431413d)• Namespace =AWS/EC2

搜索可用指标您可以使用目标搜索词，对您账户中的所有指标进行搜索。之后会返回在命名空间、指标名称或维度内具有匹配结果的指标。


Amazon CloudWatch 开发人员指南命令行工具


在 Amazon CloudWatch 中搜索可用的指标


3. 在按类别显示的CloudWatch指标窗格中的搜索指标字段内，键入搜索词、指标名称、服务名称等，然后按下 Enter 键。

例如，您可以在搜索指标字段中输入 volume，以返回名称中带有搜索词 volume的所有指标。

选择和取消选择指标您可以在AmazonCloudWatch控制台中，通过不同方式选择和取消选择指标。选择指标后，它们会自动显示在详细信息窗格的图表中，因此您有必要了解如何选择和取消选择指标以通过图表展示所需的数据。

选择或取消选择指标


3. 在按类别显示的CloudWatch指标窗格中，选择一个指标类别或在搜索指标字段内输入搜索词、指标名称、服务名称等，并按下 Enter 键。

例如，您可以在搜索指标字段中输入 volume，以返回名称中带有搜索词 volume的所有指标。4. 执行以下任一操作：

• 要选择或取消选择单个指标，请在结果窗格中选中资源名称和指标旁边的复选框。

• 要选择列表中的所有指标，在结果窗格中的列表顶部，单击全选。

要取消选择所有指标，在结果窗格中的指标列表顶部，单击清除。

• 要列出使用某项指标的所有资源，在结果窗格中的指标名称列中单击某个指标。

当您要在同一个图表中查看所有这些资源时，该操作非常有用。有关更多信息，请参阅绘制跨资源指标的图表 (p. 32)。


Amazon CloudWatch 开发人员指南选择和取消选择指标



• 要取消选择所有指标只选择一项，在结果窗格中的指标列表中，单击您要保留为选中状态的指标的资源类型和指标名称之间的空白区域。

• 要查看所有选中指标的列表，在导航窗格中的指标下，单击已选择的指标。

获取指标的统计数据这组场景演示了如何使用 AWS 管理控制台、mon-get-stats命令或 GetMetricStatistics API 来获取各种统计数据。

Note

开始和结束时间必须在最近 14 天内。

Topics• 获取指定 EC2 实例的统计数据 (p. 25)• 聚合多实例统计数据 (p. 27)• 通过 Auto Scaling 组获取聚合统计数据 (p. 28)• 通过映像 (AMI) ID 获取聚合统计数据 (p. 30)

获取指定 EC2 实例的统计数据下表描述适用于您的 Amazon EC2 实例的监控数据的类型。

描述监控类型

数据在 5 分钟期间内自动可用，无需收费。基本

额外付费的情况下，每隔 1 分钟提供一次数据。要获得此级别的数据，您必须为实例专门启用此监视。对于您已启用详细监视的实例，您还可以跨组（相似实例所在组）获得聚合数据。有关定价的信息，请转至 Amazon CloudWatch 产品页。

明细

以下场景演示了如何使用 AWS 管理控制台、mon-get-stats命令或 GetMetricStatistics API 来确定指定EC2实例的最大CPU利用率。有关监控EC2实例的更多信息，请参阅AmazonElasticComputeCloud 用户指南中的用 CloudWatch 监视您的实例。

Note



Amazon CloudWatch 开发人员指南获取指标的统计数据

http://aws.amazon.com/cloudwatch

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-cloudwatch.html

对于此例，我们假定您拥有一个 EC2 实例 ID。您可以通过 AWS 管理控制台或 EC2ec2-describe-instances CLI 命令获取有效 EC2 实例 ID。

AWS 管理控制台要显示指定实例的平均 CPU 利用率，请执行以下步骤：

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择 EC2：指标。

单个实例可用的指标显示在上方窗格中。4. 为特定实例 ID 选择包含 CPU 利用率的行。

在详细信息窗格中会出现一个显示单个实例的平均 CPUUtilization的图表。

5. 要更改指标的统计数据（例如平均值），请从弹出列表中选择不同的值。

6. 要更改周期（例如 5 分钟）以查看更详细的数据，请从弹出列表中选择不同的值。

命令行工具要获取 EC2 实例的 CPU 利用率，请执行以下步骤：

• 输入带有下列参数的 mon-get-stats命令。

Prompt>mon-get-stats CPUUtilization --start-time 2011-01-09T23:18:00 --end-time 2011-01-12T23:18:00 --period 360 --namespace "AWS/EC2" --statistics "Maximum" --dimensions "InstanceId=<your-instance-id>" --headers


Time Maximum Unit 2011-01-09 23:18:00 0.38 Percent 2011-01-09 23:24:00 0.38 Percent 2011-01-09 23:30:00 0.38 Percent 2011-01-09 23:36:00 0.38 Percent 2011-01-09 23:42:00 0.38 Percent 2011-01-09 23:48:00 0.39 Percent 2011-01-09 23:54:00 0.38 Percent 2011-01-10 00:00:00 0.38 Percent 2011-01-10 00:06:00 0.38 Percent 2011-01-10 00:12:00 0.38 Percent

返回的统计数据是以请求的2天时间为间隔的6分钟数值。每个数值代表一个EC2实例的最大CPU利用率百分比。


Amazon CloudWatch 开发人员指南获取指定 EC2 实例的统计数据


查询 API要获取 EC2 实例的 3 天范围的每小时 CPU 利用率，请执行以下步骤：

• 调用带有下列参数的 GetMetricStatistics命令：

• MetricName =CPUUtilization• Period =3600• Statistics列表包括Maximum

• Dimensions (Name=InstanceId, Value="<your-instance-id>")• Namespace =AWS/EC2• StartTime =2011-01-09T23:18:00• EndTime =2011-01-12T23:18:00

聚合多实例统计数据聚合统计数据适用于已经启用详细监控的实例。聚合中不包含使用基本监控的实例。此外，AmazonCloudWatch不跨各个地区聚合数据。因此指标在各地区间彼此独立。在获取多实例聚合统计数据前，必须启用详细监控（另外收费），以提供以1分钟为间隔的数据。此场景演示如何将详细监控与AWS管理控制台、GetMetricStatisticsAPI或mon-get-stats命令结合使用，来获取EC2实例的平均CPU利用率。因为未指定任何维度，所以 Amazon CloudWatch 会返回 AWS/EC2命名空间中所有维度的统计数据。要获取其他指标的统计数据，请参阅 Amazon CloudWatch 命名空间、维度和指标参考 (p. 79)。

Important

此方法可以在 AWS 命名空间中检索所有维度，但不适用于发布到 Amazon CloudWatch 的自定义命名空间。对于自定义命名空间，必须指定与任意给定数据关联的完整的维度组，以检索包含数据点的统计数据。

AWS 管理控制台要显示 Amazon EC2 实例的平均 CPU 利用率，请执行以下步骤：

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中的 EC2 指标下，选择跨所有实例。

跨所有实例可用的指标会在上方窗格中显示。4. 在上方窗格中，选择包含 CPU 利用率的行。

详细信息窗格中会出现一个显示 EC2 实例的 CPUUtilization的图表。




Amazon CloudWatch 开发人员指南聚合多实例统计数据


命令行工具要获取 Amazon EC2 实例的平均 CPU 利用率，请执行以下步骤：

• 输入带有下列参数的 mon-get-stats命令：

Prompt>mon-get-stats CPUUtilization --start-time 2011-01-10T23:18:00 --end-time 2011-01-12T23:18:00 --period 360 --namespace "AWS/EC2" --statistics "Average,SampleCount" --headers


Time SampleCount Average Unit 2011-01-10 14:18:00 60.0 0.1138 Percent 2011-01-10 15:18:00 60.0 0.1078 Percent 2011-01-10 16:18:00 60.0 0.3322 Percent 2011-01-10 17:18:00 60.0 0.1397 Percent 2011-01-10 18:18:00 60.0 0.1143 Percent 2011-01-10 19:18:00 60.0 0.1082 Percent 2011-01-10 20:18:00 36.0 0.1367 Percent

查询 API要获取 Amazon EC2 实例的平均 CPU 利用率，请执行以下步骤：


• MetricName =CPUUtilization• Statistics列表包括Average

• Namespace =AWS/EC2• StartTime =2011-01-10T23:18:00• EndTime =2011-01-12T23:18:00• Period =360

返回的统计数据是以 2 天时间为间隔的 6 分钟数值。

通过 Auto Scaling 组获取聚合统计数据此场景演示了如何通过将 DiskWriteBytes 指标与 AWS 管理控制台、mon-get-stats命令或GetMetricStatistics API 结合使用，来检索写入磁盘的某个 Auto Scaling 组的总字节数。总字节数按 1 分钟的周期，24 小时的时间间隔，跨指定 AutoScalingGroupName 中的所有 EC2 实例计算得出。

Note


在此例中，假定有一个 EC2 应用程序正在运行，且该应用程序包含一个名为 test-group-1的 AutoScaling 组。


Amazon CloudWatch 开发人员指南通过 Auto Scaling 组获取聚合统计数据

AWS 管理控制台显示自动扩展的 EC2 应用程序的总 DiskWriteBytes

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中的 EC2 指标下，选择按 Auto Scaling 组。

Auto Scaling 组可用的指标会在上方窗格中显示。4. 选择包含 DiskWriteBytes 的行。

详细信息窗格中将出现一个显示所有 EC2 实例的 DiskWriteBytes的图表。



命令行工具获取自动扩展的 EC2 应用程序的总 DiskWriteBytes

• 输入带有下列参数的 mon-get-stats命令。

Prompt>mon-get-stats DiskWriteBytes --start-time 2011-01-10T23:18:00 --end-time 2011-01-11T23:18:00 --period 60 --namespace AWS/EC2 --statistics "Sum,SampleCount" --dimensions "AutoScalingGroupName=test-group-1" --headers


Time SampleCount Sum Unit 2011-01-10 15:52:00 1.0 196608.0 Bytes 2011-01-10 15:53:00 1.0 180224.0 Bytes 2011-01-10 15:54:00 1.0 200704.0 Bytes 2011-01-10 15:55:00 1.0 200704.0 Bytes 2011-01-10 15:56:00 1.0 200704.0 Bytes 2011-01-10 15:57:00 1.0 180224.0 Bytes 2011-01-10 15:58:00 1.0 196608.0 Bytes 2011-01-10 15:59:00 1.0 372736.0 Bytes 2011-01-10 16:00:00 1.0 258048.0 Bytes

查询 API获取自动扩展的 EC2 应用程序的总 DiskWriteBytes



Amazon CloudWatch 开发人员指南通过 Auto Scaling 组获取聚合统计数据


• MetricName =DiskWriteBytes• Period =60• Statistics列表包括Sum

• Unit =Bytes• Dimensions (Name=AutoScalingGroupName, Value=test-group-1)• Namespace =AWS/EC2• StartTime =2011-01-10T23:18:00• EndTime =2011-01-11T23:18:00

返回的统计数据是针对整个 Auto Scaling 组以 24 小时为间隔的 1 分钟总写入字节数。

通过映像 (AMI) ID 获取聚合统计数据此场景演示了如何使用 AWS 管理控制台、mon-get-stats命令或 GetMetricStatistics API 来确定与给定映像 ID 匹配的所有实例的平均 CPU 利用率。平均值以 60 秒为时间间隔 1 天为周期。

Note


在此场景中，EC2 实例正在运行 ID 为 ami-c5e40dac的映像。

AWS 管理控制台要显示映像 ID 的平均 CPU 利用率，请执行以下步骤：

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中的 EC2 指标下，选择按映像 (AMI) ID。

上方窗格中将显示映像 ID 的可用指标。4. 选择包含 CPU 利用率和映像 ID 的行。

详细信息窗格中将出现一个显示基于 ami-c5e40dac映像 ID 的所有 EC2 实例的平均CPUUtilization的图表。



命令行工具要获取映像 ID 的平均 CPU 利用率，请执行以下步骤：

• 输入 mon-get-stats命令，如以下示例所示。


Amazon CloudWatch 开发人员指南通过映像 (AMI) ID 获取聚合统计数据


Prompt>mon-get-stats CPUUtilization --start-time 2011-01-10T00:00:00 --end-time 2011-01-11T00:00:00 --period 60 --statistics "Average" --namespace "AWS/EC2" --dimensions "ImageId=ami-c5e40dac" --headers


Time Average Unit 2011-01-10 22:42:00 0.38 Percent 2011-01-10 22:48:00 0.39 Percent 2011-01-10 22:54:00 0.38 Percent 2011-01-10 23:00:00 0.38 Percent 2011-01-10 23:06:00 0.38 Percent 2011-01-10 23:12:00 0.38 Percent

操作返回的统计数据是以 1天时间为间隔的 1分钟数值。每个数值代表运行指定系统映像的 EC2 实例的平均 CPU 利用率。

查询 API要获取映像 ID 的平均 CPU 利用率，请执行以下步骤：


• MetricName =CPUUtilization• Period =60• Statistics列表包括Average

• Dimensions (Name= ImageId, Value= ami-c5e40dac)• Namespace =AWS/EC2• StartTime =2011-01-10T00:00:00• EndTime =2011-01-11T00:00:00

绘制指标图表您可以使用 Amazon CloudWatch 控制台为其他 AWS服务生成的指标数据绘制图表，以便更轻松地查看正在运行的操作。您可以使用下列步骤在 Amazon CloudWatch 中绘制指标图表。

Topics• 绘制指标图表 (p. 32)• 绘制跨资源指标的图表 (p. 32)• 绘制多个指标的图表 (p. 33)• 修改图表中的日期和时间 (p. 33)• 修改图表的统计数据 (p. 33)• 修改图表的周期 (p. 34)• 修改图表的标题 (p. 34)• 从图表上的指标创建警报 (p. 34)• 放大图表 (p. 35)• 在图表上将时间向后移 (p. 35)


Amazon CloudWatch 开发人员指南绘制指标图表

• 在图表上将时间向前移 (p. 35)• 在图表上跳转到“现在” (p. 36)• 切换指标的 Y 轴 (p. 36)• 保存图表 (p. 36)

绘制指标图表您可以选择一项指标，并在 Amazon CloudWatch 中创建数据的图表。例如，您可以选择一个 AmazonEC2 实例的 CPU 利用率指标，显示该实例的 CPU 利用率随着时间变化的图表。

绘制指标图表

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，使用搜索指标字段和类别，按指标名称、AWS 资源或其

他元数据查找指标。4. 使用指标列表上方的滚动条及上一页和下一页箭头来翻阅整个指标列表5. 选择指标（例如 CPU 利用率）以进行查看。详细信息窗格中会显示相应图表。

6. 要保存此图表以在稍后进行访问，请在详细信息窗格中的工具下，单击复制 URL，然后在复制图表URL对话框中，选择该 URL，并将其粘贴到您的浏览器中。

绘制跨资源指标的图表您可以为跨所有资源的指标绘制图表，以在一个图表中查看所有数据。例如，您可以在一个图表中绘制所有 Amazon EC2 实例的 CPU 利用率指标。

绘制跨资源指标的图表


3. 在按类别显示的 CloudWatch 指标窗格中，选择一种指标类别。例如，在 EC2 指标下，选择每个实例的指标。

4. 在指标列表中的指标名称列，单击一项指标。例如 CPU 利用率。5. 在指标列表的顶部，单击全选。

图表会显示所选指标的所有出现次数的全部数据。以下示例中显示了所有Amazon EC2实例的CPU利用率。



Amazon CloudWatch 开发人员指南绘制指标图表



绘制多个指标的图表您可以在同一张图表中绘制多项指标随着时间的变化。例如，您可以绘制AmazonEC2实例的CPU利用率和 DiskReadBytes 图表，并在同一张图表中共同显示这些指标。

绘制多项指标的图表


他元数据查找指标。4. 选中您要绘制图表的各指标旁的复选框。您可以通过选中相应指标的复选框来添加更多指标。在图表

上将为您所选的每个复选框显示一个行。

5. 要清除所选指标并查看单个指标的数据，请单击列表中的指标名称。6. 要保存此图表以在稍后进行访问，请在详细信息窗格中的工具下，单击复制 URL，然后在复制图表

URL对话框中，选择该 URL，并将其粘贴到您的浏览器中。

修改图表中的日期和时间您可以更改图表上的时间和日期，以查看不同时间点的数据。

修改图表中的日期和时间

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中一个或多个指标对应的复选框。5. 在详细信息窗格中的时间范围部分，使用从和到字段选择新的日期范围。

6. 单击更新图表或刷新（环形箭头）按钮，以将图表更新为新的日期范围。7. 要保存此图表以在稍后进行访问，请在详细信息窗格中的工具下，单击复制 URL，然后在复制图表

URL对话框中，选择该 URL，并将其粘贴到您的浏览器中。

修改图表的统计数据CloudWatch 支持以下多种不同的指标统计数据：平均值、最小值、最大值、总和与示例。有关更多信息，请参阅统计数据 (p. 6)。

修改图表的统计数据

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中一个或多个指标对应的复选框。5. 在图表标题旁，单击统计数据下拉列表，然后选择一项统计数据，例如最大值。

将使用新选项更新图表。


Amazon CloudWatch 开发人员指南绘制多个指标的图表





修改图表的周期您可以使用CloudWatch在不同的粒度下查看您的数据。您可以按1分钟的周期来查看数据，以获得非常详细的信息。这在查看较短时间段（如 1 小时）内的数据时非常有用。您还可以按 1 小时的周期查看数据，以大致了解相关信息。这在查看更长时间段（如3天）内的数据时非常有用，使您能够查看随时间变化的趋势。有关更多信息，请参阅时间段 (p. 7)。

修改图表的周期

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中一个或多个指标对应的复选框。5. 单击周期下拉列表，然后选择新周期，例如 5 分钟。



修改图表的标题Amazon CloudWatch 会为您创建的图表提供一个默认标题。您可以根据需要编辑和更改这个标题。

修改图表的标题

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中一个或多个指标对应的复选框。5. 在详细信息窗格中，单击标题进行编辑。6. 在弹出的框中，输入新标题，然后单击保存即可更新图表标题。

从图表上的指标创建警报您可以绘制指标的图表，然后从图表上的指标创建警报，这样做的优点是可为您填充很多警报字段。

从图表上的指标创建警报

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中您要为其创建警报的指标旁的复选框。5. 在详细信息窗格中的工具下，单击创建警报，然后填写警报字段。

有关如何创建警报的更多信息，请参阅创建 Amazon CloudWatch 警报 (p. 39)。


Amazon CloudWatch 开发人员指南修改图表的周期




放大图表您可以更改图表的粒度，放大以查看数据在较短周期内的变化。

放大图表

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中一个或多个指标对应的复选框。5. 在详细信息窗格中，单击并拖动图表区，然后松开鼠标按钮。



在图表上将时间向后移在图表上将时间向后移

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中一个或多个指标对应的复选框。5. 在详细信息窗格中，将鼠标指针悬停在图表区域中的空白区域，图表的左边缘和右边缘会出现时间控

件（向左和向右箭头按钮）。6. 单击向左箭头。将使用新选项更新图表。

在图表上将时间向前移在图表上将时间向前移


件（向左和向右箭头按钮）。6. 单击向右箭头。将使用新选项更新图表。


Amazon CloudWatch 开发人员指南放大图表




在图表上跳转到“现在”在图表上跳转到“现在”


件（向左和向右箭头按钮）。6. 单击垂直行上的向右箭头。将使用新选项更新图表。

切换指标的 Y 轴您可以使用两个不同的 Y 轴显示某个图表上的多个指标。这对于单位不同或者值范围差异很大的指标尤其有用。

要切换指标的 Y 轴，请执行以下步骤：

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击指标。3. 在按类别显示的 CloudWatch 指标窗格中，选择一种类别，以查看可用指标。4. 选中一个或多个指标对应的复选框。5. 在详细信息窗格中，将鼠标指针悬停在图表上的某一行或指标的图例项上，随即会显示一个悬停框。6. 单击悬停框中的切换链接。指标随即切换到相反的轴。

保存图表您可以保存图表或为图表添加书签，以在稍后进行访问。

保存图表


他元数据查找指标。4. 使用指标列表上方的滚动条及上一页和下一页箭头来翻阅整个指标列表5. 选择要查看的指标。在以下示例中，详细信息窗格中显示了 Amazon EC2 实例的 CPU 利用率指标

的图表。

6. 在详细信息窗格中的工具下，单击复制 URL。7. 在复制图表 URL对话框中，选择该 URL，并将其粘贴到您的浏览器中。

使用您的浏览器，为页面添加书签，以便稍后进行访问。


Amazon CloudWatch 开发人员指南在图表上跳转到“现在”




发布自定义指标可以通过 mon-put-data命令（或与其相当的查询API PutMetricData）将自己的指标发布到AmazonCloudWatch。可以通过 AWS 管理控制台查看所发布指标的统计数据图表。

如果以新的指标名称调用 mon-put-data，Amazon CloudWatch 会创建一个新指标。否则，AmazonCloudWatch 会将您的数据与您指定的现有指标进行关联。

Note

当您使用mon-put-data命令创建新指标时，可能需要两分钟时间，才能使用mon-get-metrics命令检索有关新指标的统计数据。但是，可能需要最多 15 分钟时间，新的指标才会出现在使用mon-list-metrics命令检索的指标列表中。

Amazon CloudWatch 会将相关指标数据储存为一系列数据点。每个数据点包含一个相关联的时间戳。您可以通过调用 mon-put-data多次发布一个或多个数据点。甚至可以发布称为统计数据集的一系列聚合数据点。

Topics• 发布单一数据点 (p. 37)• 发布统计数据集 (p. 38)• 发布零值 (p. 38)

发布单一数据点要发布新指标或现有指标的单一数据点，可通过一个值和时间戳调用 mon-put-data。例如，下列每项操作会发布一个数据点：

mon-put-data --metric-name PageViewCount --namespace "MyService" --value 2 --timestamp 2011-03-14T12:00:00.000Zmon-put-data --metric-name PageViewCount --namespace "MyService" --value 4 --timestamp 2011-03-14T12:00:01.000Zmon-put-data --metric-name PageViewCount --namespace "MyService" --value 5 --timestamp 2011-03-14T12:00:02.000Z

Note

如果想运行此示例，则指定过去两周内的时间戳。

如果使用查询 API 代替命令行工具，则可以在 PutMetricData的一次调用中通过传递数据点列表发布最多 20 个数据点。该列表可以包含应用于不同指标的数据点，但是所有指标必须全部属于相同的命名空间。

Note

mon-put-data命令在单次调用中当前只可以发布一个数据点。

尽管可以以千分之一秒粒度的时间戳发布数据点，但AmazonCloudWatch会按一分钟的最小粒度聚合数据。例如，上面示例中的 PageViewCount指标包含三个时间戳仅仅间隔几秒的数据点。AmazonCloudWatch 会聚合这三个数据点，因为它们在一分钟内都有时间戳。


Amazon CloudWatch 开发人员指南发布自定义指标

Amazon CloudWatch 在聚合数据点时以一分钟为界线。例如，Amazon CloudWatch 会聚合上面示例中的数据点，因为全部三个数据点均在一分钟范围内，开始于 2011-03-14T12:00:00.000Z并结束于2011-03-14T12:00:59.999Z。

可以使用 mon-get-stats检索已发布数据点的统计数据。

mon-get-stats PageViewCount -n "MyService" -s "Sum,Maximum,Minimum,Average,Sample Count" --start-time 2011-03-14T12:00:00.000Z --end-time 2011-03-14T12:01:00.000Z --headers


Time SampleCount Average Sum Minimum Maximum Unit2011-03-14 12:00:00 3.0 3.6666666666666665 11.0 2.0 5.0 None

发布统计数据集将数据发布到AmazonCloudWatch之前还可以对其进行聚合。如果每分钟有多个数据点，则聚合数据时会将调用 mon-put-data的次数减到最少。例如，您可以在一次调用中将数据聚合到所发布的统计数据集中，而不是对彼此相隔三秒之内的三个数据点调用 mon-put-data多次：

mon-put-data --metric-name PageViewCount --namespace "MyService" -s "Sum=11,Minimum=2,Maximum=5,SampleCount=3" --timestamp 2011-03-14T12:00:00.000Z

发布零值如果数据比较分散并有一些包含无关联数据的时间段，则可以选择为该时间段发布值零(0)或者不发布任何值。如果对 PutMetricData使用周期性调用以监控应用程序的运行状况，则可能需要发布零值，而不是不发布任何值。例如，可以设置一个当应用程序发布指标失败时每隔五分钟向您发送通知的AmazonCloudWatch 警报。您想让这样的应用程序为不含任何关联数据的时间段发布零值。

如果想要追踪数据点的总数或需要最小和平均等统计数据包含 0 值数据点，也可以发布零值。


Amazon CloudWatch 开发人员指南发布统计数据集

创建 Amazon CloudWatch 警报

您可以创建 Amazon CloudWatch 警报，并在警报改变状态时发送 Amazon Simple Notification Service消息。警报按指定的时间段监控单个指标，并根据相对于给定阈值的指标值每隔若干个时间段执行一项或多项操作。该操作是一个发送到 Amazon Simple Notification Service 主题或 Auto Scaling 策略的通知。警报仅在出现持续状态变化时才会调用操作。Amazon CloudWatch 警报将不会仅因为其处于特定状态而调用操作，该状态必须已改变并在指定的若干个时间段内保持不变。

因为状态改变而导致警报调用操作后，其后续行为取决于您关联到警报的操作类型。对于 Auto Scaling策略通知，警报会在其保持新状态的每个周期中继续调用操作。对于AmazonSimpleNotificationService通知，不会调用额外操作。

警报中包含三个状态：

• OK—指标位于规定的阈值范围内• ALARM—指标在规定的阙值范围外• INSUFFICIENT_DATA—警报刚启动，指标不可用，或指标数据不足以判断警报状态

在下方图表中，警报阈值设为 3 且最小违反值为 3 个时间段。即，警报仅在阈值连续 3 个时间段违反规定时调用其操作。在此图中，这种情况发生在第三个到第五个时间段，且警报的状态设为 ALARM。在第六个时间段，数值下降到阈值以下，而状态变为 OK。之后，在第九个时间段中，阈值再次被打破，但不是必须的连续三个时间段。因此，警报状态保持为 OK。

Note

AmazonCloudWatch不会测试或验证您指定的操作，也不会检测因试图调用不存在的操作而导致的任何 Auto Scaling 或 SNS 错误。确保您的操作存在。

警报的常见功能

• 每个 AWS 账户可以创建最多 5000 个警报。要创建或更新警报，可以使用 PutMetricAlarm API 函数（mon-put-metric-alarm命令）。

• 可使用 DescribeAlarms API（mon-describe-alarms命令）列出任何或所有当前配置的警报以及处于特定状态的任何警报。可以根据时间范围对列表进行进一步筛选。

• 可使用 DisableAlarmActions和 EnableAlarmActions API（mon-disable-alarm-actions和 mon-enable-alarm-actions命令）禁用和启用警报。



• 可使用SetAlarmStateAPI（mon-set-alarm-state命令）将警报设为任意状态以对其进行测试。此短暂状态变更只会持续到下一个警报比较发生之时。

• 最后，可使用 DescribeAlarmHistory API（mon-describe-alarm-history命令）查看警报的历史记录。Amazon CloudWatch 会将警报历史记录保存两个星期。每个状态转换都标有一个唯一的时间戳。个别情况下，一个状态变更的历史记录可能显示多个通知。通过时间戳可以确定唯一的状态变更。

Note

在特定条件下，一些 AWS 资源不会将指标数据发送到 Amazon CloudWatch。

例如，Amazon EBS 不会发送未连接到 Amazon EC2 实例的可用卷的指标数据，因为该卷没有要监控的指标活动。如果您对此类指标设置了警报，您可能会注意到其状态更改为“数据不足”。这可能只表示您的资源处于不活动状态，可能并不意味着有问题。

Topics• 设置 Amazon Simple Notification Service (p. 40)• 创建警报 (p. 43)• 根据 CPU 利用率警报发送电子邮件 (p. 43)• 根据负载均衡器警报发送电子邮件 (p. 45)• 根据存储吞吐量警报发送电子邮件 (p. 46)• 创建停止或终止实例的警报 (p. 48)

设置 Amazon Simple Notification ServiceAmazon CloudWatch 使用 Amazon Simple Notification Service (Amazon SNS) 发送电子邮件。本部分介绍如何创建和订阅 Amazon Simple Notification Service 主题。创建 Amazon CloudWatch 警报后，可以添加此 Amazon SNS 主题，以在警报状态改变时发送电子邮件通知。有关 Amazon Simple NotificationService 的更多信息，请参阅 Amazon Simple Notification Service 入门指南。

Note

如果使用 AWS Management Console 创建 Amazon CloudWatch 警报，则可跳过此过程，因为您可在创建警报向导中的配置操作一步中创建 Amazon Simple Notification Service 主题。

Topics• AWS 管理控制台 (p. 40)• 命令行工具 (p. 42)

AWS 管理控制台要通过 AWS 管理控制台设置 Amazon Simple Notification Service 主题，首先需要创建一个主题，然后订阅该主题。然后可以直接向该主题发布一条消息，确保已经将其配置妥当。

创建 Amazon Simple Notification Service 主题

1. 通过以下网址打开 Amazon SNS 控制台：https://console.aws.amazon.com/sns/。2. 在入门中，单击创建新主题。

此时会打开创建新主题对话框。


Amazon CloudWatch 开发人员指南设置 Amazon Simple Notification Service

http://docs.aws.amazon.com/sns/latest/gsg/

https://console.aws.amazon.com/sns/

3. 在主题名称字段中输入主题名称 MyTopic。4. 单击创建主题。

主题详细信息页中将显示新主题。

5. 为下一个任务复制主题 ARN。

订阅 Amazon Simple Notification Service 主题

1. 通过以下网址打开 Amazon SNS 控制台：https://console.aws.amazon.com/sns/。2. 在导航窗格中，单击导航窗格中的我的订阅。

将打开我的订阅页面。3. 单击创建新订阅。

将打开订阅对话框。

4. 在主题 ARN字段中，粘贴您在上一任务中已创建的主题 ARN，例如：arn:aws:sns:us-east-1:054794666394:MyTopic.

5. 在协议下拉列表中选择电子邮件。6. 在终端节点字段中输入可用于接收通知的电子邮件地址，然后单击订阅。

Important

Entourage 用户：Entourage 清除确认URL。请在不同的电子邮件应用程序中输入您可以访问的电子邮件地址。

7. 进入您的电子邮件应用程序，打开来自 AWS 通知的消息，然后单击链接，确认订阅。

您的Web 浏览器将显示来自 Amazon Simple Notification Service 的确认响应。

发布到 Amazon Simple Notification Service 主题

1. 通过以下网址打开 Amazon SNS 控制台：https://console.aws.amazon.com/sns/。2. 在导航窗格中的我的主题下，单击要发布的主题。

将打开主题详细信息页面。3. 单击发布至主题。

将打开发布对话框。

4. 在主题字段中输入消息的主题行，然后在消息字段中输入一段简短消息。5. 单击发布消息。

您将看到确认对话框。6. 单击关闭。


Amazon CloudWatch 开发人员指南AWS 管理控制台



7. 查看电子邮件，确认收到该主题发出的消息。

命令行工具此场景介绍如何使用命令行工具创建 Amazon Simple Notification Service 主题，然后将消息直接发布到该主题，以确保已经对其进行适当配置。

Note

此场景使用Amazon Simple Notification Service命令行工具。要下载Amazon Simple NotificationService 命令行工具，请转至 http://aws.amazon.com/developertools/3688。

设置 Amazon Simple Notification Service 主题

1. 通过 Amazon Simple Notification Service CLI 命令 sns-create-topic创建该主题。您会收到一个作为返回值的主题资源名称：

Prompt>sns-create-topic --name MyTopic

Amazon Simple Notification Service 会返回以下主题 ARN：

arn:aws:sns:us-east-1:887848922426:MyTopic

2. 通过 Amazon Simple Notification Service CLI 命令 sns-subscribe向该主题订阅电子邮件地址。如果订阅请求成功，您会收到一封确认电子邮件。

Prompt>sns-subscribe --topic arn:aws:sns:us-east-1:887848922426:MyTopic --protocol SMTP --endpoint <your-email-address>

Amazon Simple Notification Service 将返回以下内容：

Subscription request received

3. 单击邮件正文中的确认链接确认您想要接收来自 Amazon Simple Notification Service 的电子邮件，完成订阅过程。

4. 通过 Amazon Simple Notification Service CLI 命令 sns-list-subscription-by-topic查看订阅。

Prompt>sns-list-subscription-by-topic --topic arn:aws:sns:us-east-1:887848922426:MyTopic


arn:aws:sns:us-east-1:887848922426:MyTopic:97fbacb0-7706-4ee9-9f8c-d56074b25278 SMTP me@my_company.com

5. 通过 sns-publish命令将一条消息直接发布到该主题，确保该主题已经配置妥当。



http://aws.amazon.com/developertools/3688

Prompt>sns-publish --message "Verification" --topic arn:aws:sns:us-east-1:887848922426:MyTopic


b94635b4-9cc6-4895-b961-87e9a1ff8ff8

6. 查看电子邮件，确认收到该主题发出的消息。

创建警报可从 Amazon CloudWatch 控制台中的警报列表创建警报。

创建警报

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击警报。3. 单击创建警报，然后在按类别显示的CloudWatch指标窗格中，选择一个指标类别，例如EC2指标。4. 选择一个指标（例如 CPU 利用率），然后在导航窗格中，单击下一步。5. 在警报阈值中填写各字段，然后在操作下，选择在触发警报时警报要执行的操作类型。

可以选择特定指标以触发警报并为这些指标指定阈值。然后可以设置警报使其在指标超出您定义的阈值时改变状态。有关如何创建发送电子邮件的警报，请参阅创建AmazonCloudWatch警报 (p. 39)。

6. 单击创建警报。

根据 CPU 利用率警报发送电子邮件此场景介绍如何使用 AWS管理控制台或命令行工具创建一个 Amazon CloudWatch 警报，当警报状态从“正常”变为“警报”时，该警报会发送 Amazon Simple Notification Service 电子邮件。

在此场景中，可以将警报配置为，当 EC2 实例的 CPU利用率超过 70%长达两个连续 5分钟时间段时，变更为“警报”状态。


AWS 管理控制台创建根据 CPU 利用率发送电子邮件的警报

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击警报。3. 单击创建警报，然后在按类别显示的CloudWatch指标窗格中，选择一个指标类别，例如EC2指标。4. 在指标列表中，选择包含特定实例 ID 的 CPU 利用率的行。


Amazon CloudWatch 开发人员指南创建警报



下方窗格中会出现一个显示单个实例的平均 CPUUtilization的图表。

5. 从统计数据下拉列表中选择平均。6. 从周期下拉列表中选择一个周期，例如：5 。7. 在导航窗格中，单击下一步。8. 在警报阈值下的名称字段中，为警报输入一个唯一名称，例如：myHighCpuAlarm。9. 在描述字段中，输入警报描述，例如：CPU 70%

10. 在条件下拉列表中选择 >。11. 在条件下拉列表旁的框内输入 70，在时间字段中输入 10。

警报预览下会显示阈值的图形表示。12. 在操作下，在每当此警报下拉列表中选择状态为“警报”。13. 在发送通知到下拉列表中，选择一个现有 Amazon SNS 主题或创建一个新主题。14. 要创建新的 Amazon SNS 主题，请选择创建主题。

在发送通知到字段中，为新的Amazon SNS主题输入一个名称，例如：myHighCpuAlarm，并在电子邮件列表字段中，输入当警报变为 ALARM状态时接收通知电子邮件的地址列表（以逗号分隔）。

15. 在导航窗格中，单击创建警报以完成警报创建过程。

命令行工具在 CPU 利用率超过 70% 时发送 Amazon Simple Notification Service 电子邮件

1. 设置 Amazon Simple Notification Service 主题或检索要使用的主题的“主题资源名称”。有关设置Amazon Simple Notification Service 主题的帮助，请参阅设置 Amazon Simple NotificationService (p. 40)。

2. 通过 Amazon CloudWatch CLI 命令 mon-put-metric-alarm创建一个警报。使用以下示例中的值，但是以您自己的值替换 InstanceID和 alarm-actions的值。

Prompt>mon-put-metric-alarm --alarm-name cpu-mon --alarm-description "Alarm when CPU exceeds 70%" --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 70 --comparison-operator GreaterThanThreshold --di mensions "InstanceId=i-12345678" --evaluation-periods 2 --alarm-actions arn:aws:sns:us-east-1:887848922426:MyTopic --unit Percent


OK-Created Alarm

3. 通过使用 Amazon CloudWatch CLI 命令 mon-set-alarm-state强制改变警报状态，来对该警报进行测试。

a. 将警报状态从 INSUFFICIENT_DATA更改为 OK：

Prompt>mon-set-alarm-state cpu-mon --state-reason "initializing" --state-value OK




OK-Set alarm state value

b. 将警报状态从 OK更改为 ALARM：

Prompt>mon-set-alarm-state cpu-mon --state-reason "testing" --state-value ALARM



c. 查看是否已经收到电子邮件。

根据负载均衡器警报发送电子邮件此场景介绍如何使用 AWS 管理控制台或命令行工具设置 Amazon Simple Notification Service 通知和配置警报，以监控超过 100 ms 的负载均衡器延迟。


AWS 管理控制台创建发送电子邮件的负载均衡器警报

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击警报。3. 单击创建警报，然后在按类别显示的CloudWatch指标窗格中，选择一个指标类别，例如ELB指标。4. 在指标列表中，选择包含特定负载均衡器的 Latency 的行。

下方窗格中会出现一个显示单个负载均衡器的平均 Latency的图表。

5. 从统计数据下拉列表中选择平均。6. 从周期下拉列表中选择 1 分钟。7. 在导航窗格中，单击下一步。8. 在警报阈值下的名称字段中，为警报输入一个唯一名称，例如：myHighCpuAlarm。9. 在描述字段中，输入警报描述，例如： 100ms

10. 在条件下拉列表中选择 >。11. 在条件下拉列表旁的框内输入 0.1，在时间字段中输入 3。

警报预览下会显示阈值的图形表示。


Amazon CloudWatch 开发人员指南根据负载均衡器警报发送电子邮件


12. 在操作下，在每当此警报下拉列表中选择状态为“警报”。13. 在发送通知到下拉列表中，选择一个现有 Amazon SNS 主题或创建一个新主题。14. 要创建新的 Amazon SNS 主题，请选择创建主题。



命令行工具在负载均衡器延迟超过 100 毫秒时发送 Amazon Simple Notification Service 电子邮件

1. 创建一个 Amazon Simple Notification Service 主题。请参阅设置 Amazon Simple NotificationService (p. 40) 中创建 Amazon SNS 主题的说明

2. 创建警报。

Prompt>mon-put-metric-alarm --alarm-name lb-mon --alarm-description "Alarm when Latency exceeds 100ms" --metric-name Latency --namespace AWS/ELB --statistic Average --period 60 --threshold 100 --comparison-operator GreaterThanThreshold --dimensions LoadBalancerName=my-server --evaluation-periods 3 --alarm-ac tions arn:aws:sns:us-east-1:1234567890:my-topic --unit Milliseconds


OK-Created Alarm

3. 测试警报。

• 将警报状态强制变为 ALARM：

Prompt>mon-set-alarm-state --state OKPrompt>mon-set-alarm-state --state ALARM



• 查看是否已经收到电子邮件。

根据存储吞吐量警报发送电子邮件此场景介绍如何使用 AWS 管理控制台或命令行工具设置 Amazon Simple Notification Service 通知，以及配置当 EBS 超过 100 MB 吞吐量时发送电子邮件的警报。

Topics• AWS 管理控制台 (p. 47)



• 命令行工具 (p. 47)

AWS 管理控制台创建发送电子邮件的存储吞吐量警报

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击警报。3. 单击创建警报，然后在按类别显示的CloudWatch指标窗格中，选择一个指标类别，例如EBS指标。4. 在指标列表中，选择包含特定 VolumeId 的卷写入字节数的行。

下方窗格中会出现一个显示单个卷的平均 VolumeWriteBytes的图表。

5. 从统计数据下拉列表中选择平均。6. 从周期下拉列表中选择 5 分钟。7. 在导航窗格中，单击下一步。8. 在警报阈值下的名称字段中，为警报输入一个唯一名称，例如：myHighWriteAlarm。9. 在描述字段中，输入警报描述，例如： 100,000 KiB/s

10. 在条件下拉列表中选择 >。11. 在条件下拉列表旁的框内输入 100000，在时间字段中输入 15。

警报预览下会显示阈值的图形表示。12. 在操作下，在每当此警报下拉列表中选择状态为“警报”。13. 在发送通知到下拉列表中，选择一个现有 Amazon SNS 主题或创建一个新主题。14. 要创建新的 Amazon SNS 主题，请选择创建主题。



命令行工具在 EBS 吞吐量超过 100 MB 时发送 Amazon Simple Notification Service 电子邮件

1. 创建一个 Amazon Simple Notification Service 主题。请参阅设置 Amazon Simple NotificationService (p. 40) 中创建 Amazon SNS 主题的说明。

2. 创建警报。

Prompt>mon-put-metric-alarm --alarm-name ebs-mon --alarm-description "Alarm when EBS volume exceeds 100MB throughput" --metric-name VolumeReadBytes --namespace AWS/EBS --statistic Average --period 300 --threshold 100000000 --comparison-operator GreaterThanThreshold --dimensions VolumeId=my-volume-id --evaluation-periods 3 --alarm-actions arn:aws:sns:us-east-1:1234567890:my-alarm-topic --insufficient-data-actions arn:aws:sns:us-east-1:1234567890:my-insufficient-data-topic


Amazon CloudWatch 开发人员指南AWS 管理控制台



OK-Created Alarm

3. 测试警报。

• 将警报状态强制变为 ALARM。

Prompt>mon-set-alarm-state --state OKPrompt>mon-set-alarm-state --state ALARMPrompt>mon-set-alarm-state --state INSUFFICIENT_DATA

• 查看是否已经收到两封电子邮件。

创建停止或终止实例的警报使用AmazonCloudWatch警报操作，您可以创建当不再需要让Amazon Elastic Compute Cloud (AmazonEC2) 实例运行时自动将其停止或终止的警报。例如，您可能拥有专用于批工资单处理工作或科学计算任务的实例，这些实例在运行一段时间后就完成了其工作。与其让这些进程保持空闲（并产生费用）不如将其停止或终止以节省开支。使用停止警报操作和终止警报操作的主要区别是，停止的警报可以在需要时轻松重启，还可以保留相同的实例 ID 和根卷。而终止的实例则无法重新启动。如此就必须启动一个新的实例。

可以向为 Amazon EC2 实例指标设置的任何警报中添加停止或终止警报操作，这些指标包括 AmazonCloudWatch 提供的基本和详细监控指标（在 AWS/EC2 命名空间中），以及包含“InstanceId=”维度的自定义指标，只要 InstanceId 值引用有效运行的 Amazon EC2 实例。

Topics• 向 Amazon CloudWatch 警报中添加操作 (p. 48)• Amazon CloudWatch 警报操作场景 (p. 57)

向 Amazon CloudWatch 警报中添加操作可以使用Amazon EC2或 Amazon CloudWatch控制台配置警报操作，也可以使用Amazon CloudWatch命令行界面(CLI)、API或AWS开发工具包执行此操作。有关结合使用AmazonCloudWatchAPI和AWS开发工具包的信息，请参阅示例代码和库。

使用 Amazon EC2 控制台创建停止实例的警报可以创建当达到一定阈值后停止 Amazon EC2 实例的警报。例如，您可能运行了开发或测试实例而偶尔忘记将其关闭。可以创建当平均CPU利用率低于 10%达 24小时时触发的警报，同时告知其为空闲并不再使用。可以根据需要调整阈值、时长和时间段，还可以添加AmazonSimpleNotificationService (AmazonSNS) 通知，以便您在触发警报后能够收到电子邮件。

可以停止或终止将 Amazon Elastic Block Store 卷用作根设备的 Amazon EC2 实例，但只能终止将实例存储用作根设备的实例。


Amazon CloudWatch 开发人员指南创建停止或终止实例的警报

http://aws.amazon.com/code/

Note

如果您要使用 AWS Identity and Access Management (IAM) 账户创建或修改警报，则必须拥有以下 Amazon EC2 权限：ec2:DescribeInstanceStatus、ec2:DescribeInstances、ec2:StopInstances和ec2:TerminateInstances才能执行警报操作。如果您拥有对AmazonCloudWatch 而不是 Amazon EC2 的读/写权限，则仍然可以创建警报，但无法对 Amazon EC2实例执行停止或终止操作。但是，如果您之后获得使用相关AmazonEC2API的权限，将会执行之前创建的警报操作。有关 IAM 权限的更多信息，请参阅使用 IAM 中的许可与策略。

要创建停止空闲实例的警报

1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。2. 在导航窗格中的实例下，单击实例。3. 在上方窗格中，右键单击一个实例，然后单击添加/编辑警报。

也可以选择该实例，然后在下方窗格中的监控选项卡上单击创建警报。4. 在以下项的警报详细信息对话框中，单击创建警报。

5. 如果您要在触发警报时接收电子邮件，请在针对以下项创建警报对话框中的发送通知到框中选择一个现有 Amazon SNS 主题，或单击创建主题创建新的主题。

如果创建新主题，请在发送通知到框中输入主题的名称，然后在收件人如下框中键入收件人的电子邮件地址（以逗号分隔）。之后，待警报创建完成，您将收到一封订阅确认电子邮件，而您必须接受方可获得该主题的电子邮件。


Amazon CloudWatch 开发人员指南向 Amazon CloudWatch 警报中添加操作

http://docs.aws.amazon.com/IAM/latest/UserGuide/PermissionsAndPolicies.html

https://console.aws.amazon.com/ec2/

6. 选中请执行以下操作复选框，然后选择停止单选按钮。7. 在每当框中，选择想要使用的统计数据，然后选择指标。在此示例中，选择平均和 CPU 利用率。8. 在是框中，定义指标阈值。在此示例中，输入 10%。9. 在在至少框中，选择警报的采样周期。在此示例中，输入以 1 小时为间隔的 24 个连续时间段。10. 要更改警报的名称，可在命名此警报框中键入新名称。

如果不输入警报名称，Amazon CloudWatch 会自动为您创建一个。

Note

可以在创建警报前根据自己的要求调整警报配置，也可以在之后编辑配置。这包括指标、阈值、时长、操作和通知等设置。但是，警报创建后其名称无法再次编辑。


使用 Amazon EC2 控制台创建终止实例的警报可以创建当达到一定阈值时自动终止 EC2 实例的警报（只要该实例未启用终止保护）。例如，某个实例已经完成工作，您不再需要此实例而想将其终止。如果可能在之后使用该实例，则应该选择停止而不是终止。有关对实例启用和禁用终止保护的信息，请参阅Amazon Elastic Compute Cloud 用户指南中的为实例启用终止保护。

Note


要创建终止空闲实例的警报

1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。2. 在导航窗格中的实例下，单击实例。3. 在上方窗格中，右键单击一个实例，然后单击添加/编辑警报。



http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_ChangingDisableAPITermination.html



https://console.aws.amazon.com/ec2/

或者选择实例，然后在下方窗格中的监控选项卡上单击创建警报。4. 在以下项的警报详细信息对话框中，单击创建警报。

5. 如果希望在触发警报后接收电子邮件，请在针对以下项创建警报对话框中的发送通知到框中选择一个现有 SNS 主题，或单击创建主题创建新的主题。

如果创建新主题，请在发送通知到框中输入主题的名称，然后在收件人如下框中键入收件人的电子邮件地址（以逗号分隔）。之后，待警报创建完成，您将收到一封订阅确认电子邮件，而您必须接受方可获得该主题的电子邮件。

6. 选择执行操作复选框，然后选择终止单选按钮。7. 在每当框中，选择想要使用的统计数据，然后选择指标。在此示例中，选择平均和 CPU 利用率。8. 在是框中，定义指标阈值。在此示例中，输入 10%。9. 在在至少框中，选择警报的采样周期。在此示例中，输入以 1 小时为间隔的 24 个连续时间段。10. 要更改警报的名称，可在命名此警报框中键入新名称。

如果不输入警报名称，Amazon CloudWatch 会自动为您创建一个。

Note

可以在创建警报前根据自己的要求调整警报配置，也可以在之后编辑配置。这包括指标、阈值、时长、操作和通知等设置。但是，警报创建后其名称无法再次编辑。




使用 Amazon CloudWatch 控制台创建停止实例的警报可以创建当达到一定阈值后停止 Amazon EC2 实例的警报。例如，您可能运行了开发或测试实例而偶尔忘记将其关闭。可以创建当平均CPU利用率低于 10%达 24小时时触发的警报，同时告知其为空闲并不再使用。可以调整阈值、时长和时间段以符合您的需要，还可以添加AmazonSimpleNotificationService(Amazon SNS) 通知，让您在警报触发后收到电子邮件。

Amazon CloudWatch 警报操作可以停止由 EBS 支持的 Amazon EC2 实例，但无法停止由实例存储支持的AmazonEC2实例。但是，AmazonCloudWatch警报操作可以终止这两种类型的AmazonEC2实例。

Note


要创建停止空闲实例的警报

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击警报。3. 在上方窗格中，单击创建警报。4. 单击创建警报，然后在按类别显示的CloudWatch指标窗格中的EC2指标下，选择每个实例的指标。5. 在指标列表中，选择您要为其创建警报的实例和指标。还可以在搜索框中输入一个实例 ID 以便找到

所需的实例。6. 从统计数据下拉列表中选择平均。7. 从周期下拉列表中选择一个周期，例如：1 。8. 在导航窗格中，单击下一步。9. 在警报阈值下的名称字段中，为警报输入一个唯一名称，例如： EC2 。10. 在描述字段中，输入警报描述，例如： CPU EC2

11. 在条件下拉列表中，选择 <。12. 在条件下拉列表旁的框内，输入 10并在目标字段内输入 1440。

警报预览下会显示阈值的图形表示。13. 在操作下，单击“EC2 操作”。14. 在每当此警报下拉列表中，选择状态为“警报”。15. 在请执行以下操作下拉列表中，选择停止此实例。16. 单击通知，然后在发送通知到下拉列表中，选择一个现有 Amazon SNS 主题或创建一个新的主题。17. 要创建新的 Amazon SNS 主题，请选择创建主题。

在发送通知到字段中，为新的 Amazon SNS 主题输入一个名称，例如：Stop_EC2_Instance，在电子邮件列表字段中，输入警报变为 ALARM状态时接收通知的电子邮件地址列表（以逗号分隔）。

Important

如果创建新主题或向现有主题添加电子邮件地址，则每个电子邮件地址会收到一封主题订阅确认电子邮件。必须点击其中包含的链接对订阅进行确认，方可让新的电子邮件地址接收通知。






使用 Amazon CloudWatch 控制台创建终止空闲实例的警报在对 Amazon EC2 实例禁用终止保护后，可以创建当达到一定阈值时自动终止该实例的警报。例如，某个实例已经完成工作，您不再需要此实例而想将其终止。如果可能在之后使用该实例，则应该选择停止而不是终止。有关对实例禁用终止保护的信息，请参阅Amazon Elastic Compute Cloud 用户指南中的为实例启用终止保护。

Note


要创建终止空闲实例的警报

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击警报。3. 在上方窗格中，单击创建警报。4. 单击创建警报，然后在按类别显示的CloudWatch指标窗格中的EC2指标下，选择每个实例的指标。5. 在指标列表中，选择您要为其创建警报的实例和指标。还可以在搜索框中输入一个实例 ID 以便找到

所需的实例。6. 从统计数据下拉列表中选择平均。7. 从周期下拉列表中选择一个周期，例如：1 。8. 在导航窗格中，单击下一步。9. 在警报阈值下的名称字段中，为警报输入一个唯一名称，例如： EC2 。10. 在描述字段中，输入警报描述，例如： CPU EC2

11. 在条件下拉列表中选择 <。12. 在条件下拉列表旁的框内，输入 10并在目标字段内输入 1440。

警报预览下会显示阈值的图形表示。13. 在操作下，单击“EC2 操作”。14. 在每当此警报下拉列表中，选择状态为“警报”。15. 在请执行以下操作下拉列表中，选择终止此实例。16. 单击通知，然后在发送通知到下拉列表中，选择一个现有 Amazon SNS 主题或创建一个新的主题。17. 要创建新的 Amazon SNS 主题，请选择创建主题。

在发送通知到字段中，为新的AmazonSNS主题输入一个名称，例如：Terminate_EC2_Instance，在电子邮件列表字段中，输入警报变为 ALARM状态时要接收通知的电子邮件地址列表（以逗号分隔）。

Important

如果创建新主题或向现有主题添加电子邮件地址，则每个电子邮件地址会收到一封主题订阅确认电子邮件。必须点击其中包含的链接对订阅进行确认，方可让新的电子邮件地址接收通知。








使用 Amazon CloudWatch 控制台查看已触发的警报和操作的历史记录您可以在 Amazon CloudWatch 控制台中查看警报和操作历史记录。Amazon CloudWatch 会保留最近两周的警报和操作历史记录。

要查看已触发的警报和操作的历史记录

1. 通过以下网址打开 Amazon CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。2. 在导航窗格中，单击警报。3. 在上方窗格中，选择包含您想要查看的历史记录的警报。4. 在下方窗格中，详细信息选项卡显示最近的状态转换以及时间和指标值。5. 单击历史记录选项卡可以查看最近的历史记录条目。

使用 CLI 或 API 创建警报以停止或终止实例如果使用Amazon CloudWatch CLI或API，或者结合使用AWS开发工具包和API，则可以使用AmazonEC2 实例指标创建一个 Amazon CloudWatch 警报，然后使用操作的专用亚马逊资源名称 (ARN) 添加操作。可以向任何警报状态添加操作，同时可以指定每项操作的地区。地区必须与您发送 put-metric-alarm请求的地区匹配。

ARN（包含地区）操作

arn:aws:automate:us-east-1:ec2:stopStop

arn:aws:automate:us-east-1:ec2:terminateTerminate

有关结合使用 Amazon CloudWatch API 和 AWS 开发工具包的信息，请参阅示例代码和库。

Note


要使用 CLI 创建停止实例的警报

可以使用 arn:aws:automate:us-east-1:ec2:stop ARN停止Amazon EC2实例。下方实例展示了当平均 CPU 利用率低于 10% 超过一个 24 小时时间段时如何停止实例。

• 在命令提示符下，输入：

% mon-put-metric-alarm my-Alarm \ --namespace "AWS/EC2" \ -- dimensions " InstanceId=i-abc123" \--statistic Average \ --metric- name CPUUtilization \ --comparison-operator LessThanThreshold \




http://aws.amazon.com/code/


--threshold 10 \ --period 86400 \ --evaluation-periods 4 \ -- alarm-actionsarn:aws:automate:us-east-1:ec2:stop

要使用 CLI 创建终止实例的警报

• 在命令提示符下，输入：

% mon-put-metric-alarm my-Alarm \ --namespace "AWS/EC2" \ -- dimensions " InstanceId=i-abc123" \--statistic Average \ --metric- name CPUUtilization \ --comparison-operator GreaterThanThreshold\ --threshold 10 \ --period 86400 \ --evaluation-periods 4 \ --alarm-actions arn:aws:automate:us-east-1:ec2:terminate

要使用 API 创建警报与停止实例

下面的示例请求演示如何创建停止 Amazon EC2 实例的警报。

• 创建以下请求：

http://monitoring.amazonaws.com/

?SignatureVersion=2

&Action=PutMetricAlarm

&Version=2009-05-15

&Namespace=AWS/EC2

&MetricName=CPUUtilization

&Dimension.member.1.Name=instance-id

&Dimension.member.1.Value=i-abc123

&Period=86400

&Statistic=Average

&AlarmName=Stop-EC2-Instance

&ComparisonOperator=LessThanThreshold

&Threshold=10

&EvaluationPeriods=4

&StartTime=2009-01-16T00:00:00

&EndTime=2009-01-16T00:02:00

&Timestamp=2009-01-08-18



&AWSAccessKeyId=XXX YOUR ACCESS KEY XXX

&Signature=%XXX YOUR SIGNATURE XXX%3D

&AlarmActions.member.1=arn:aws:automate:us-east-1:ec2:stop

要使用 API 创建警报与终止实例

下面的示例演示如何创建终止 Amazon EC2 实例的警报。

• 创建以下请求：

http://monitoring.amazonaws.com/

?SignatureVersion=2

&Action=PutMetricAlarm

&Version=2009-05-15

&Namespace=AWS/EC2

&MetricName=CPUUtilization

&Dimension.member.1.Name=instance-id

&Dimension.member.1.Value=i-abc123

&Period=86400

&Statistic=Average

&AlarmName=Terminate-EC2-Instance

&ComparisonOperator=LessThanThreshold

&Threshold=10

&EvaluationPeriods=4

&StartTime=2009-01-16T00:00:00

&EndTime=2009-01-16T00:02:00

&Timestamp=2009-01-08-18

&AWSAccessKeyId=XXX YOUR ACCESS KEY XXX

&Signature=%XXX YOUR SIGNATURE XXX%3D

&AlarmActions.member.1=arn:aws:automate:us-east-1:ec2:terminate



Amazon CloudWatch 警报操作场景可以使用AmazonElasticComputeCloud (AmazonEC2)控制台创建当满足一定条件时停止或终止AmazonEC2 实例的警报操作。在下方的控制台页面屏幕截图中，您设置了警报操作，我们对设置进行了编号。我们还对后续场景中的设置进行了编号，帮助您创建合适的操作。

场景 1：停止空闲开发与测试实例创建当用于软件开发或测试的实例空闲达到至少 1 小时时停止该实例的警报。

值Setting

停止

最大值

CPU 利用率

<=

10%

60 minutes

1

场景 2：停止空闲实例创建一个当实例空闲达到 24 小时时停止该实例并发送电子邮件的警报。

值Setting

Stop and email

平均值


Amazon CloudWatch 开发人员指南Amazon CloudWatch 警报操作场景

值Setting

CPU 利用率

<=

5%

60 minutes

24

场景 3：出现异常高流量时停止Web 服务器创建一个当实例的出站网络流量每天超过 10 GB 时发送电子邮件的警报。

值Setting

电子邮件

总计

网络输出

>

10 GB

1 day

1

场景 4：出现异常高流量时停止Web 服务器创建当出站流量超过每小时 1 GB 时停止实例并发送短消息 (SMS) 的警报。

值Setting

Stop and send SMS

总计

网络输出

>

1 GB

1 小时



值Setting

1

场景 5：停止出现内存泄漏的实例创建当内存利用率达到或超过 90% 时停止实例的警报，让应用程序日志可以被检索用于故障排除。

值Setting

停止

最大值

MemoryUtilization

>=

90%

1 minute

1

场景 6：停止受损的实例创建当实例连续 3 次状态检查（每隔 5 分钟执行一次）皆为故障时将其停止的警报。

值Setting

停止

平均值

系统状态检查失败

>=

1

15 minutes

1

场景 7：当批处理作业完成时终止实例创建当实例不再发送结果数据时终止运行批处理作业的实例的警报。



值Setting

终止

最大值

网络输出

<=

100,000 bytes

5 minutes

1

还可以使用AmazonCloudWatch控制台执行上述场景。我们已对控制台上的设置进行编号，以将AmazonEC2 控制台中已编号的设置与上面提到的场景相对应，以便您进行比较，并按照适当操作创建警报。



Amazon EC2 实例的监控脚本

用于基于AmazonElastic Compute Cloud (Amazon EC2) Linux和Windows的实例的AmazonCloudWatch监控脚本演示了如何生成和使用 Amazon CloudWatch 自定义指标。用于 Linux 的脚本是一些 Perl 脚本范例，其中包含一个可报告有关Linux实例的内存、交换文件和磁盘空间利用率指标的功能完备的示例。用于Windows 的脚本是一些PowerShell 脚本范例，其中包含一个可报告有关Windows 实例的内存、页面文件和磁盘空间利用率的功能完备的示例。可以从Amazon Web Services (AWS) 示例代码库下载用于Linux 和 Windows 的 Amazon CloudWatch 监控脚本，并将其安装在基于 Linux 或 Windows 的实例中。

Important

这些脚本只是示例。他们依“原样”提供且不受支持。

Topics• 用于 Linux 的 Amazon CloudWatch监控脚本 (p. 61)• 用于 Windows 的 Amazon CloudWatch 监控脚本 (p. 66)

用于 Linux 的 Amazon CloudWatch监控脚本用于 Linux 的 Amazon CloudWatch 监控脚本是一些 Perl 脚本范例，可演示如何生成和使用 AmazonCloudWatch自定义指标。该脚本包括一个功能完备的示例，以报告有关AmazonElastic Compute Cloud(Amazon EC2) Linux 实例的内存、交换和磁盘空间利用率指标。

Topics• 先决条件 (p. 62)• 入门 (p. 62)• 使用脚本 (p. 63)• 在 AWS 管理控制台中查看自定义指标 (p. 66)

可从 AWS 示例代码库下载用于 Linux 的 Amazon CloudWatch 监控脚本。CloudWatchMonitoringScripts-v1.1.0.zip 程序包包含以下文件：

• CloudWatchClient.pm – 共享 Perl 模块，以简化从其他脚本调用 Amazon CloudWatch 的过程。• mon-put-instance-data.pl – 收集 Amazon EC2 实例中的系统指标（内存、交换、磁盘空间利用率）并将其发送到 Amazon CloudWatch。


Amazon CloudWatch 开发人员指南用于 Linux 的 Amazon CloudWatch监控脚本

http://aws.amazon.com/code/8720044071969977

• mon-get-instance-stats.pl – 查询 Amazon CloudWatch 并显示在其上执行此脚本的 EC2 实例的最近利用率统计数据。

• – AWS 证书的文件模板，用于储存您的访问密钥 ID 和私有访问密钥。• LICENSE.txt – 包含 Apache 2.0 许可证的文本文件。• NOTICE.txt – 版权声明。

这些监控脚本专门用于运行 Linux 操作系统的 Amazon EC2 实例。这些脚本均在下列亚马逊系统映像(AMI)（包括 32 位和 64 位版本）上进行过测试：

• Amazon Linux 2011.09.02• Red Hat Enterprise Linux 6.3• Ubuntu Server 12.04• SUSE Linux Enterprise Server 11

先决条件某些版本的 Linux 必须执行额外步骤。

Ubuntu Server如果运行 Ubuntu Server，请使用以下步骤配置您的服务器。

• 登录到您的 Ubuntu Server 实例并安装下列程序包：

sudo apt-get install unzip libwww-perl libcrypt-ssleay-perl

Red Hat Enterprise Linux 或 SUSE Linux如果运行RedHat Enterprise Linux或SUSE Linux Enterprise Server，请使用以下步骤配置您的服务器。

1. 在命令提示符处，输入 cd /切换到根目录。2. 在每个提示符处，键入 perl -MCPAN -e shell，然后键入 yes。3. 在 cpan[1]>提示符处，键入 install Bundle::LWP5_837 LWP以安装 LWP 包并更新到 LWP

版本 6.03。在每个提示符处键入 yes。

有关如何连接到Amazon EC2 Linux 实例的信息，请参阅Amazon Elastic Compute Cloud 用户指南中的连接到实例。

入门下列步骤介绍如何在 EC2 Linux 实例上下载、解压缩和配置 CloudWatch 监控脚本。

要下载、安装和配置脚本

• 打开命令提示符，移至想要储存脚本的文件夹并输入以下内容：

wget http://ec2-downloads.s3.amazonaws.com/cloudwatch-samples/CloudWatchMon itoringScripts-v1.1.0.zipunzip CloudWatchMonitoringScripts-v1.1.0.zip


Amazon CloudWatch 开发人员指南先决条件

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html

rm CloudWatchMonitoringScripts-v1.1.0.zipcd aws-scripts-mon

使用脚本mon-put-instance-data.pl此脚本会收集当前系统的内存、交换和磁盘空间利用率数据。然后远程调用 Amazon CloudWatch，以自定义指标的形式报告收集到的数据。

选项

描述姓名

以百分比收集和发送 MemoryUtilization 指标。此选项只报告由应用程序和操作系统分配的内存，不包括缓存和缓冲区中的内存。

--mem-util

收集和发送 MemoryUsed 指标（以兆字节报告）。此选项只报告由应用程序和操作系统分配的内存，不包括缓存和缓冲区中的内存。

--mem-used

收集和发送 MemoryAvailable 指标（以兆字节报告）。此选项会报告应用程序和操作系统可以使用的内存。

--mem-avail

收集和发送 SwapUtilization 指标（以百分比报告）。--swap-util

收集和发送 SwapUsed 指标（以兆字节报告）。--swap-used

选择要报告的磁盘。PATH 可以为需要报告的文件系统指定装入点或装入点上的任何文件。如需选择多个磁盘，请为每个磁盘分别指定--disk-path=PATH。要为装载于/和/home位置的文件系统选择磁盘，请使用下列参数：--disk-path=/ --disk-path=/home

--disk-path=PATH

收集和发送选定磁盘的 DiskSpaceUtilization 指标。指标以百分比报告。

--disk-space-util

收集和发送选定磁盘的 DiskSpaceUsed 指标。指标默认以千兆字节报告。受限于Linux操作系统中的保留磁盘空间，已用磁盘空间和可用磁盘空间可能无法准确相加得到磁盘空间总量。

--disk-space-used

收集和发送选定磁盘的 DiskSpaceAvailable 指标。指标以千兆字节报告。受限于Linux操作系统中的保留磁盘空间，已用磁盘空间和可用磁盘空间可能无法准确相加得到磁盘空间总量。

--disk-space-avail

指定报告内存使用率所采用的单位。如果不指定，则内存以兆字节报告。单位可以是以下一种：字节、千字节、兆字节、千兆字节。

--memory-units=UNITS

指定报告磁盘空间使用率所采用的单位。如果不指定，则磁盘空间以千兆字节报告。单位可以是以下一种：字节、千字节、兆字节、千兆字节。

--disk-space-units=UNITS


Amazon CloudWatch 开发人员指南使用脚本

描述姓名

提供包含 AWS 证书的文件的位置。此参数不能与 --aws-access-key-id和 -aws-secret-key参数一起使用。

--aws-credential-file=PATH

指定用于识别发起人的 AWS 访问密钥 ID。必须与--aws-secret-key选项一起使用。不要将此选项与--aws-credential-file参数一起使用。

--aws-access-key-id=VALUE

指定用于签署 CloudWatch 请求的 AWS 私有访问密钥。必须与--aws-access-key-id选项一起使用。不要将此选项与--aws-credential-file参数一起使用。

--aws-secret-key=VALUE

会对收集指标的脚本执行一次试运行，准备完整HTTP请求，但是不会调用CloudWatch以报告数据。此选项还会检查是否已提供证书。在详细模式中运行时，此选项输出的指标会发送到 AmazonCloudWatch。

--verify

从 cron 调用脚本时，请使用此选项。使用此选项时，会阻止所有诊断输出，但错误消息会发送到用户账户的本地系统日志。

--from-cron

显示脚本正在处理的内容的详细信息。--verbose

显示使用率信息。--help

显示脚本的版本号。--version

示例

下列示例假定您已经使用有效的AWS证书更新了 awscreds.conf文件。如果不使用 awscreds.conf文件，则使用 --aws-access-key-id和 --aws-secret-key参数提供证书。

执行简单试运行而不将数据发布到 Amazon CloudWatch

• 运行以下命令：

./mon-put-instance-data.pl --mem-util --verify --verbose

收集所有可用内存指标并将其发送到 Amazon CloudWatch


./mon-put-instance-data.pl --mem-util --mem-used --mem-avail

为报告到 Amazon CloudWatch 的指标制定 cron 计划

1. 使用下列命令开始编辑 crontab：

crontab -e



2. 添加下列命令，每五分钟将内存和磁盘空间利用率报告到 CloudWatch：

*/5 * * * * ~/aws-scripts-mon/mon-put-instance-data.pl --mem-util --disk-space-util --disk-path=/ --from-cron

如果脚本遇到错误，则会在系统日志中写下错误消息。

mon-get-instance-stats.pl此脚本可在使用最近小时数提供的时间间隔内查询AmazonCloudWatch中有关内存、交换和磁盘空间指标的统计数据。将为对其执行此脚本的 Amazon EC2 实例提供该数据。

选项

描述姓名

指定报告依据的最近小时数，由 N表示，其中 N是一个整数。--recent-hours=N

提供包含 AWS 证书的文件的位置。--aws-credential-file=PATH

指定用于识别发起人的 AWS 访问密钥 ID。必须与--aws-secret-key选项一起使用。不要将此选项与--aws-credential-file选项一起使用。

--aws-access-key-id=VALUE

指定用于签署 CloudWatch 请求的 AWS 私有访问密钥。必须与--aws-access-key-id选项一起使用。不要将此选项与--aws-credential-file选项一起使用。

--aws-secret-key=VALUE

会对收集指标的脚本执行一次试运行，准备完整HTTP请求，但是不会调用CloudWatch以报告数据。此选项还会检查是否已提供证书。在详细模式中运行时，此选项输出的指标会发送到 AmazonCloudWatch。

--verify

显示脚本正在处理的内容的详细信息。--verbose

显示使用率信息。--help

显示脚本的版本号。--version

示例

要获取最近 12 小时的利用率统计信息


mon-get-instance-stats.pl --recent-hours=12

返回的响应与下列示例输出类似：

Instance metric statistics for the last 12 hours.

CPU Utilization Average: 1.06%, Minimum: 0.00%, Maximum: 15.22%



Memory Utilization Average: 6.84%, Minimum: 6.82%, Maximum: 6.89%

Swap Utilization Average: N/A, Minimum: N/A, Maximum: N/A

Disk Space Utilization on /dev/xvda1 mounted as / Average: 9.69%, Minimum: 9.69%, Maximum: 9.69%

在 AWS 管理控制台中查看自定义指标如果成功调用mon-put-instance-data.pl脚本，则可以使用AWS管理控制台查看在Amazon CloudWatch控制台中发布的自定义指标。

要查看自定义指标

1. 如前所述执行 mon-put-instance-data.pl。2. 登录 AWS 管理控制台，并通过以下网址打开 Amazon CloudWatch 控制台：

https://console.aws.amazon.com/cloudwatch/。3. 单击查看指标。4. 在查看下拉列表中，所显示的由脚本发布的自定义指标带有前缀 System/Linux。

用于Windows 的 Amazon CloudWatch 监控脚本用于Windows 的 Amazon CloudWatch 监控脚本是一些 PowerShell 脚本范例，可演示如何生成和使用AmazonCloudWatch自定义指标。该脚本包括一个功能完备的示例，以报告有关AmazonElasticComputeCloud (Amazon EC2) Windows 实例的内存、页面文件和磁盘空间利用率指标。

Topics• 入门 (p. 67)• 使用脚本 (p. 67)

可以从AmazonWebServices (AWS)示例代码库下载AmazonCloudWatchMonitoring Scripts forMicrosoftWindows Server。AmazonCloudWatchMonitoringWindows.zip 程序包包含以下文件：

• mon-put-metrics-mem.ps1 – 收集 Amazon EC2 Windows 实例的系统指标（内存、页面文件利用率）并将其发送到 Amazon CloudWatch。

• mon-put-metrics-disk.ps1 – 收集 Amazon EC2 实例的系统指标（磁盘空间利用率）并将其发送到Amazon CloudWatch。

• mon-put-metrics-perfmon.ps1 – 收集 Amazon EC2 实例的 PerfMon 计数器并将其发送到 AmazonCloudWatch。

• mon-get-instance-stats.ps1 – 查询 Amazon CloudWatch 并显示在其上执行此脚本的 EC2 实例的最近利用率统计数据。

• awscreds.conf – AWS 证书的文件模板，用于储存您的访问密钥 ID 和私有访问密钥。• LICENSE.txt – 包含 Apache 2.0 许可证的文本文件。• NOTICE.txt – 版权声明。


Amazon CloudWatch 开发人员指南在 AWS 管理控制台中查看自定义指标




这些监控脚本专门用于运行 Microsoft Windows Server 操作系统的 Amazon EC2 实例。这些脚本均在下列亚马逊系统映像 (AMI)（包括 32 位和 64 位版本）上进行过测试：

• Windows Server 2003 R2• Windows Server 2008• Windows Server 2008 R2

入门下列步骤演示如何在 Amazon EC2 Windows 实例上下载、解压缩和配置 Amazon CloudWatch 监控脚本。

要下载、安装和配置脚本

1. 连接到 Amazon EC2 Windows 实例。有关如何连接到 Amazon EC2 Windows 实例的信息，请参阅Amazon Elastic Compute Cloud 用户指南中的连接到Windows 实例。

2. 将适用于 .NET 的 AWS 开发工具包下载并安装到需要监控的 EC2 实例上。3. 将包含 Amazon CloudWatch Monitoring Scripts for Microsoft Windows Server 的 .zip 文件下载到

EC2 实例上，将其解压缩到所需位置。4. 更新之前下载的 awscreds.conf 文件。此文件的内容应该使用以下格式：

AWSAccessKeyId=YourAccessKeyID

AWSSecretKey=YourSecretAccessKey

Note

如果已经为证书创建文件，则此步骤为可选步骤。可以使用现有文件，方法是，调用脚本时，在命令行中指定其位置。也可以设置环境变量 AWS_CREDENTIAL_FILE以指向包含AWS 证书的文件。

关于如何访问证书的说明，请使用下列步骤。

使用脚本mon-put-metrics-mem.ps1此脚本会收集当前系统的内存和页面文件利用率数据。然后远程调用 Amazon CloudWatch，以自定义指标的形式报告收集到的数据。

选项

描述姓名

以百分比收集和发送 MemoryUtilization 指标。此选项只报告由应用程序和操作系统分配的内存，不包括缓存和缓冲区中的内存。

-mem_util

收集和发送 MemoryUsed 指标（以兆字节报告）。此选项只报告由应用程序和操作系统分配的内存，不包括缓存和缓冲区中的内存。

-mem_used

收集和发送 MemoryAvailable 指标（以兆字节报告）。此选项会报告应用程序和操作系统可以使用的内存。

-mem_avail


Amazon CloudWatch 开发人员指南入门

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/LaunchingAndUsingInstancesWindows.html

http://aws.amazon.com/sdkfornet/


描述姓名

收集和发送 PageUtilization 指标（以百分比报告）。页面利用率在窗口实例中针对每个页面文件进行报告。

-page_util

收集和发送 PageUsed 指标（以兆字节报告）。-page_used

报告所有磁盘的页面文件中可用的空间。-page_avail

指定报告内存使用率所采用的单位。如果不指定，则内存以兆字节报告。单位可以是以下一种：字节、千字节、兆字节、千兆字节。

-memory_units UNITS

提供包含 AWS 证书的文件的位置。此参数不能与-aws_access_id和-aws_secret_key参数一起使用。

-aws_credential_file=PATH

指定用于识别发起人的AWS访问密钥ID。必须与-aws_secret_key选项一起使用。不要将此选项与 -aws_credential_file选项一起使用。

-aws_access_id=VALUE

指定用于向 Amazon CloudWatch 签署请求的 AWS私有访问密钥。必须与 -aws_access-key_id选项一起使用。不要将此选项与-aws_credential_file选项一起使用。

-aws_secret_key=VALUE

会对收集指标的脚本执行一次试运行，但不会真正调用 AmazonCloudWatch 以报告数据。此选项还会检查是否已提供证书。

-whatif

从任务计划程序调用脚本时，请使用此选项。使用此选项时，会阻止所有诊断输出，但错误消息会发送到日志文件。

-from_scheduler

显示脚本正在处理的内容的详细信息。-verbose

显示使用率信息。Get-helpmon-put-metrics-mem.ps1

显示脚本的版本号。-version

日志文件用于记录错误消息。与 -from_scheduler 选项一起使用。如果没有为日志文件指定任何值，则会创建一个包含.log扩展名的与脚本相同的默认文件。

-logfile

示例

下列示例假定您已经使用有效的AWS证书更新了 awscreds.conf文件。如果不使用 awscreds.conf文件，则使用 -aws_access_id和 -aws_secret_key参数提供证书。

使用内联访问 ID 和私有密钥收集所有可用内存指标并将数据发送到 Amazon CloudWatch


.\mon-put-metrics-mem.ps1 -aws_access_id ThisIsMyAccessKey -aws_secret_key ThisIsMySecretKey -mem_util -mem_avail -page_avail -page_used -page_util -memory_units Megabytes



使用证书文件收集所有可用内存指标并将数据发送到 Amazon CloudWatch


.\mon-put-metrics-mem.ps1 -aws_credential_file C:\awscreds.conf -mem_util -mem_used -mem_avail -page_avail -page_used -page_util -memory_units Megabytes

使用环境变量中储存的证书收集所有可用内存指标并将数据发送到 Amazon CloudWatch


.\mon-put-metrics-mem.ps1 -mem_util -mem_used -mem_avail -page_avail -page_used -page_util -memory_units Megabytes

mon-put-metrics-disk.ps1此脚本会收集当前系统的磁盘空间利用率数据。然后远程调用 Amazon CloudWatch，以自定义指标的形式报告收集到的数据。

选项

描述姓名

收集和发送选定磁盘的 DiskSpaceUtilization 指标。指标以百分比报告。

-disk_space_util

收集和发送选定磁盘的 DiskSpaceUsed 指标。指标默认以千兆字节报告。

-disk_space_used

收集和发送选定磁盘的 DiskSpaceAvailable 指标。指标以千兆字节报告。

-disk_space_avail

指定报告内存使用率所采用的单位。如果不指定，则内存以千兆字节报告。单位可以是以下一种：字节、千字节、兆字节、千兆字节。

-disk_space_units UNITS

选择要报告的驱动器号。要报告驱动器 C和 D 的指标，请使用下列选项 -disk_drive C:, D:应以逗号隔开各个值。

-disk_drive

提供包含AWS证书的文件的位置。此参数不能与–aws_access_id和 -aws_secret_key参数一起使用。

-aws_credential_file PATH

指定用于识别发起人的AWS访问密钥ID。必须与–aws_secret_key选项一起使用。不要将此选项与 -aws_credential_file选项一起使用。

-aws_access_id VALUE

指定用于向 Amazon CloudWatch 签署请求的 AWS私有访问密钥。必须与 -aws_access_id选项一起使用。不要将此选项与-aws_credential_file选项一起使用。

-aws_secret_key VALUE


-whatif



描述姓名


-from_scheduler


显示使用率信息。Get-helpmon-put-metrics-disk.ps1


日志文件用于记录错误消息。与–from_scheduler选项一起使用。如果没有为日志文件指定任何值，则会创建一个包含.log扩展名的与脚本相同的默认文件。

-logfile

示例

使用内联访问 ID 和私有密钥收集所有可用磁盘指标并将数据发送到 Amazon CloudWatch


.\mon-put-metrics-disk.ps1 -aws_access_id ThisIsMyAccessKey -aws_secret_key ThisIsMySecretKey -disk_space_util -disk_space_avail -disk_space_units Gigabytes

使用证书文件收集所有可用磁盘指标并将数据发送到 Amazon CloudWatch


.\mon-put-metrics-disk.ps1 -aws_credential_file C:\awscreds.conf -disk_drive C:, D: -disk_space_util -disk_space_used -disk_space_avail -disk_space_units Gigabytes

使用环境变量中储存的证书收集所有可用磁盘指标并将数据发送到 Amazon CloudWatch


.\mon-put-metrics-disk.ps1 -disk_drive C:, D: -disk_space_util -disk_space_used -disk_space_avail -disk_space_units Gigabytes

mon-put-metrics-perfmon.ps1此脚本会收集当前系统的PerfMon计数器。然后远程调用AmazonCloudWatch，以自定义指标的形式报告收集到的数据。



选项

描述姓名

报告当前处理器队列计数器。-processor_queue

报告内存页面/输入内存计数器。-pages_input








-whatif


-from_scheduler


显示使用率信息。Get-helpmon-put-metrics-disk.ps1


日志文件用于记录错误消息。与–from_scheduler选项一起使用。如果没有为日志文件指定任何值，则会创建一个包含.log扩展名的与脚本相同的默认文件。

-logfile

示例

使用内联访问 ID 和私有密钥收集脚本中的预设 PerfMon 计数器并将数据发送到 AmazonCloudWatch


.\mon-put-metrics-perfmon.ps1 -aws_access_id ThisIsMyAccessKey -aws_secret_key ThisIsMySecretKey -pages_input -processor_queue

使用证书文件收集脚本中的预设 PerfMon 计数器并将数据发送到 Amazon CloudWatch


.\mon-put-metrics-perfmon.ps1 -aws_credential_file C:\awscreds.conf -pages_input -processor_queue



使用环境变量中储存的证书收集脚本中的预设PerfMon计数器并将数据发送到AmazonCloudWatch


.\mon-put-metrics-perfmon.ps1 -pages_input -processor_queue

添加更多将推送到 Amazon CloudWatch 的计数器

1. 在诸如记事本等文本编辑器中打开脚本，然后在第 72 行中找到下列注释区段：

### Add More counters here.#$Counters.Add('\Memory\Cache Bytes','Bytes')#$Counters.Add('\\localhost\physicaldisk(0 c:)\% disk time','Percent')

Note

第一个参数（例如，$Counters.Add）为 PerfMon 计数器。第二个参数（例如，('\Memory\Cache Bytes','Bytes')）为计数器提供的数据的单位。

2. 按照上方所示的方法编辑脚本并将您自己的 PerfMon 计数器添加脚本中。将自定义 PerfMon 计数器添加到脚本后，除证书信息外无需任何参数即可运行脚本。

Note

只能在您的计算机上将 PerfMon 计数器添加到脚本中。可以使用 Get-Counter命令测试PerfMon 计数器。有关更多信息，请参阅 Microsoft TechNet 网站上的 Get-Counter。

mon-get-instance-stats.ps1此脚本在使用最近小时数提供的时间间隔内查询AmazonCloudWatch中有关内存、页面文件和磁盘空间指标的统计数据。将为对其执行此脚本的 Amazon EC2 实例提供该数据。

选项

描述姓名

指定报告依据的最近小时数，由 N表示，其中 N是一个整数。-recent-hours N










http://technet.microsoft.com/en-us/library/hh849685.aspx

描述姓名

显示使用率信息。Get-helpmon-get-instance-stats.ps1


示例

使用内联访问 ID 和私有密钥获取最近 12 小时的利用率统计数据并将数据发送到 AmazonCloudWatch


.\ mon-get-instance-stats.ps1 -aws_access_id ThisIsMyAccessKey -aws_secret_key ThisIsMySecretKey -re cent_hours 12

使用证书文件获取最近 12 小时的利用率统计数据并将数据发送到 Amazon CloudWatch


.\mon-get-instance-stats.ps1 -aws_credential_file C:\awscreds.conf -re cent_hours 12

使用环境变量中储存的证书获取最近 12 小时的利用率统计数据并将数据发送到 AmazonCloudWatch


.\mon-get-instance-stats.ps1 -recent_hours 12

返回的响应与下列示例输出类似：

Assembly LoadedInstance Metrics for last 12 hours.CPU UtilizationAverage: 4.69 % Maximum: 10.47 % Minimum: 1.16 %

Memory UtilizationAverage: 14.45 % Maximum: 14.77 % Minimum: 14.38 %

pagefileUtilization(c:\pagefile.sys)Average: 0.00 % Maximum: 0.00 % Minimum: 0.00 %

Volume Utilization C:Average: 17.28 % Maximum: 17.28 % Minimum: 17.28 %



Volume Utilization D:Average: 1.41 % Maximum: 1.41 % Minimum: 1.41 %

pagefileUtilization(f:\pagefile.sys)Average: 0.00 % Maximum: 0.00 % Minimum: 0.00 %pagefileUtilization(f:\pagefile.sys)Average: 0 Maximum: 0 Minimum: 0

pagefileUtilization(f:\pagefile.sys)Average: 0 Maximum: 0 Minimum: 0

设置任务计划程序以将指标报告发送到 Amazon CloudWatch可以使用Windows 任务计划程序定期向 Amazon CloudWatch 发送指标报告。

要设置任务计划程序以将指标报告发送到 Amazon CloudWatch，请执行以下步骤：

1. 在 Windows Server 实例上，依次单击开始、管理工具和任务计划程序。2. 在操作菜单上，单击创建任务。3. 在创建任务对话框中的常规选项卡上的名称框中，键入任务的名称，然后选择不管用户是否登录都要

运行。4. 在触发器选项卡上，单击新建。5. 在新建触发器对话框中的设置下，选择一次。6. 在高级设置下，选择重复任务间隔，从下拉列表中选择 5 分钟。7. 在持续时间下拉菜单中，选择无限期，然后单击确定。

Note

这些设置会创建每隔5分钟无限启动脚本的触发器。要修改此任务使其按设定的天数运行，请选中过期日期复选框。

8. 在操作选项卡上，单击新建。9. 在操作下拉菜单中，选择启动程序。10. 在设置下的程序/脚本框中，键入 Powershell.exe。11. 在添加参数(可选)框中，键入 -command "C:\scripts\mon-put-metrics-disk.ps1

-disk_drive C:,d -disk_space_util -disk_space_units gigabytes -from_scheduler-logfile C:\mylogfile.log"，然后单击确定。

12. 在创建任务对话框中，单击确定。

如果选择了一个用户账户运行此任务，则任务计划程序会提示用户证书。输入将运行此任务的账户的用户名和密码，然后单击确定。

Note

如果使用的PerfMon计数器不要求管理员权限，则可以使用系统账户替代管理员账户运行此任务。在创建任务对话框中的常规选项卡上，单击更改用户或组，然后选择一个系统账户。



控制用户访问您的 AWS 账户

Amazon CloudWatch 集成了AWS Identity and Access Management (IAM)，使您可以指定用户可以在您的AWS账户中执行哪些Amazon CloudWatch操作。例如，您可以创建一个 IAM策略，以便只允许您的组织中的特定用户使用GetMetricStatistics。之后他们可以使用此操作检索关于您的云资源的数据。

您无法使用 IAM 控制对特定资源的 Amazon CloudWatch 数据的访问。例如，您无法向用户授予只访问特定实例集或特定负载均衡器的 Amazon CloudWatch 数据的权限。使用 IAM 授予的权限涵盖您用于Amazon CloudWatch 的所有云资源。除此之外，您也不能将 IAM角色用于Amazon CloudWatch 命令行工具。

Important

结合使用IAM和AmazonCloudWatch并不会改变您使用AmazonCloudWatch的方式。AmazonCloudWatch 操作没有发生变化，并且没有与用户和访问控制相关的新 Amazon CloudWatch 操作。

要查看包含 Amazon CloudWatch 操作的策略的示例，请参阅 Amazon CloudWatch 策略示例 (p. 77)。

Topics• Amazon CloudWatch ARN (p. 75)• Amazon CloudWatch 操作 (p. 76)• Amazon CloudWatch 密钥 (p. 76)• Amazon CloudWatch 策略示例 (p. 77)

Amazon CloudWatch ARNAmazonCloudWatch不为您提供控制访问的任何特定资源。因此，IAM策略中没有可供您使用的AmazonCloudWatch ARN。在编写控制对 Amazon CloudWatch 操作的访问的策略时，您可以使用 * 作为资源。有关 ARN 的更多信息，请访问使用 IAM 中的 ARN。

但是，如果您使用 Amazon CloudWatch CLI 或 API，或者结合使用 AWS 开发工具包和 API，则可使用Amazon EC2实例指标创建一个AmazonCloudWatch警报，然后使用操作的专用亚马逊资源名称(ARN)添加操作。可以向任何警报状态添加操作，同时可以指定每项操作的地区。地区必须与您发送put-metric-alarm 请求的地区匹配。有关更多信息，请参阅使用 CLI 或 API 创建警报以停止或终止实例 (p. 54)。


Amazon CloudWatch 开发人员指南Amazon CloudWatch ARN

http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html#Identifiers_ARNs

ARN（包含地区）操作

arn:aws:automate:us-east-1:ec2:stopStop

arn:aws:automate:us-east-1:ec2:terminateTerminate

Amazon CloudWatch 操作在 IAM 策略中，您可以指定 Amazon CloudWatch 提供的任何以及所有操作。操作名称必须以小写字符串 cloudwatch:、ec2:或 autoscaling:作为前缀。例如：cloudwatch:GetMetricStatistics、cloudwatch:ListMetrics或 cloudwatch:*（适用于所有 Amazon CloudWatch 操作）。下面列出了 IAM 策略中可指定用于 Amazon CloudWatch 的操作。

操作服务

cloudwatch:DeleteAlarmsAmazon CloudWatch

cloudwatch:DescribeAlarmHistoryAmazon CloudWatch

cloudwatch:DescribeAlarmsAmazon CloudWatch

cloudwatch:DescribeAlarmsForMetricAmazon CloudWatch

cloudwatch:DisableAlarmActionsAmazon CloudWatch

cloudwatch:EnableAlarmActionsAmazon CloudWatch

cloudwatch:GetMetricStatisticsAmazon CloudWatch

cloudwatch:ListMetricsAmazon CloudWatch

cloudwatch:PutMetricAlarmAmazon CloudWatch

cloudwatch:PutMetricDataAmazon CloudWatch

cloudwatch:SetAlarmStateAmazon CloudWatch

ec2:DescribeInstanceStatusAmazon EC2

ec2:DescribeInstancesAmazon EC2

ec2:StopInstancesAmazon EC2

ec2:TerminateInstancesAmazon EC2

autoscaling:ScalingAuto Scaling

autoscaling:TriggerAuto Scaling

Amazon CloudWatch 密钥Amazon CloudWatch 实施以下策略密钥，而不是其他任何策略密钥。有关策略密钥的更多信息，请访问使用 IAM 中的条件。

适用整个 AWS 范围的策略密钥

• aws:CurrentTime—检查日期/时间条件。


Amazon CloudWatch 开发人员指南Amazon CloudWatch 操作

http://docs.aws.amazon.com/IAM/latest/UserGuide/AccessPolicyLanguage_ElementDescriptions.html#Condition

• aws:EpochTime—使用纪元日期或 UNIX 时间检查日期/时间条件。• aws:principaltype—检查当前请求的委托人类型（用户、账户、联合用户等）。• aws:SecureTransport—检查请求是否是使用 SSL 发送的。对于仅使用 SSL 的服务（如 AmazonRDS 和 Amazon Route 53），aws:SecureTransport密钥没有意义。

• aws:SourceArn—使用来源的亚马逊资源名称 (ARN)检查请求的来源。（该值仅适用于某些服务。有关更多信息，请参阅 Amazon Simple Queue Service 开发人员指南中“元素描述”下的亚马逊资源名称(ARN)。）

• aws:SourceIp—检查请求者的IP地址。请注意，如果您使用aws:SourceIp，并且请求是来自AmazonEC2 实例，则会评估实例的公有 IP 地址。

• aws:UserAgent—检查发出请求的客户端应用程序。• aws:userid—检查请求者的用户 ID。• aws:username—检查请求者的用户名称（如果可用）。

Note

密钥名称区分大小写。

Amazon CloudWatch 策略示例下面显示了一些用于控制用户对 Amazon CloudWatch 的访问的策略示例。要了解 IAM 策略声明中有关这些部分的更多信息，请参阅使用 IAM 中的IAM 策略元素参考。

Note

根据策略的既定目标，Amazon CloudWatch 未来可能会添加适当包含在以下策略中的新操作。

Example 用于检索 Amazon CloudWatch 数据的策略示例

下面的策略示例允许某个组检索 Amazon CloudWatch 数据，但前提是该组在请求中必须使用 SSL。

{ "Version": "2012-10-17", "Statement":[{ "Effect":"Allow", "Action":["cloudwatch:GetMetricStatistics","cloudwatch:ListMetrics"], "Resource":"*", "Condition":{ "Bool":{ "aws:SecureTransport":"true" } } } ]}


Amazon CloudWatch 开发人员指南Amazon CloudWatch 策略示例

http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AccessPolicyLanguage_ElementDescriptions.html#Conditions_ARN

http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AccessPolicyLanguage_ElementDescriptions.html#Conditions_ARN

http://docs.aws.amazon.com/IAM/latest/UserGuide//AccessPolicyLanguage_ElementDescriptions.html

Example 用于停止或终止 Amazon EC2 实例的策略示例

以下策略示例允许 Amazon CloudWatch 警报操作停止或终止 Amazon EC2 实例。在以下示例中，GetMetricStatistics、ListMetrics和DescribeAlarms操作是可选的。建议您选择这些操作以确保正确停止或终止了实例。

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricAlarm" "cloudwatch:GetMetricStatistics" "cloudwatch:ListMetrics" "cloudwatch:DescribeAlarms" ], "Sid": "00000000000000", "Resource": [ "*" ], "Effect": "Allow" }, { "Action": [ "ec2:DescribeInstanceStatus", "ec2:DescribeInstances", "ec2:StopInstances", "ec2:TerminateInstances" ], "Sid": "00000000000000", "Resource": [ "*" ], "Effect": "Allow" } ]}

有关 IAM 的更多信息，请参阅：

• AWS Identity and Access Management (IAM)• IAM 入门指南• 使用 IAM


Amazon CloudWatch 开发人员指南Amazon CloudWatch 策略示例

http://aws.amazon.com/iam

http://docs.aws.amazon.com/IAM/latest/GettingStartedGuide/

http://docs.aws.amazon.com/IAM/latest/UserGuide/

AmazonCloudWatch命名空间、维度和指标参考

本部分包含您可用于AmazonCloudWatch的所有命名空间、维度和指标。命名空间是指标的容器。指标是按时间排序的一系列数据点，在不同的命名空间中彼此独立，因此来自不同应用程序的指标不会被错误地聚合到相同的统计数据中。此外，每个指标都有一个维度，它是一个可帮助您唯一地标识指标的名称/值对。

Topics• AWS 命名空间 (p. 79)• Auto Scaling 维度与指标 (p. 80)• Amazon DynamoDB 维度与指标 (p. 82)• Amazon EBS 维度与指标 (p. 87)• Amazon Elastic Compute Cloud 维度与指标 (p. 88)• Elastic Load Balancing 维度与指标 (p. 91)• Amazon Elastic MapReduce 维度与指标 (p. 92)• Amazon RDS 维度与指标 (p. 96)• Amazon Simple Notification Service 维度与指标 (p. 98)• Amazon SQS 维度与指标 (p. 99)• AWS Storage Gateway 维度与指标 (p. 100)

AWS 命名空间命名空间是指标的容器。提供Amazon CloudWatch数据的所有AWS服务均使用以“AWS/”开头的命名空间字符串。下列服务可将指标数据点推送到 Amazon CloudWatch。

命名空间AWS 产品

AWS/AutoScalingAuto Scaling

AWS/DynamoDBAmazon DynamoDB

AWS/EBSAmazon Elastic Block Store


Amazon CloudWatch 开发人员指南AWS 命名空间

命名空间AWS 产品

AWS/EC2Amazon Elastic Compute Cloud

AWS/ELBElastic Load Balancing

AWS/ElasticMapReduceAmazon Elastic MapReduce

AWS/RDSAmazon Relational Database Service

AWS/StorageGatewayAWS Storage Gateway

Auto Scaling 维度与指标本部分讨论Auto Scaling 实例和组发送到Amazon CloudWatch 的指标，还介绍如何启用详细（1分钟）监控和基本（5 分钟）监控。有关如何监控 Auto Scaling 的更多信息，请参阅 Auto Scaling 开发人员指南中的 Monitor Your Auto Scaling Instances。

Topics• Auto Scaling 实例支持 (p. 80)• Auto Scaling 组支持 (p. 82)

Auto Scaling 实例支持本部分讨论 Auto Scaling 实例发送到 Amazon CloudWatch 的指标。实例指标是单个Amazon EC2 实例发送到 Amazon CloudWatch 的指标。实例指标是适用于任何 Amazon EC2 实例的相同指标，与其是否在Auto Scaling 组中无关。有关Amazon EC2实例的实例指标的信息，请参阅Amazon Elastic ComputeCloud 维度与指标 (p. 88)。

Amazon CloudWatch 提供基本监控或详细监控。基本监控每隔 5 分钟向 Amazon CloudWatch 发送一次有关每个实例的聚合数据。详细监控通过每分钟从每个实例发送聚合数据提供更密集的监控。

Note

选择详细监控是收集Auto Scaling组指标的前提。有关更多信息，请参阅the section called “AutoScaling 组支持” (p. 82)。

以下部分描述如何启用详细监控或基本监控。

激活 Auto Scaling 详细实例监控要为新 Auto Scaling 组启用详细实例监控，您不需要执行任何额外操作。在创建 Auto Scaling 组时，首先要执行的步骤之一是创建启动配置。每个启动配置包含一个名为 InstanceMonitoring.Enabled的标志。此标志的默认值为 true，因此无需设置此标志即可启用详细监控。

如果您为某个 Auto Scaling 组明确选择了基本监控，那么要切换到详细监控则涉及多个步骤，尤其当您将 Amazon CloudWatch 警报配置为自动扩展该组时。

将现有 Auto Scaling 组切换到详细实例监控

1. 创建一个已启用 InstanceMonitoring.Enabled标志的启动配置。如果使用命令行工具，可使用--monitoring-enabled选项创建启动配置。

2. 使用上一步中创建的启动配置调用UpdateAutoScalingGroup以更新AutoScaling组。AutoScaling将对其所创建的新实例启用详细监控。


Amazon CloudWatch 开发人员指南Auto Scaling 维度与指标

http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-instance-monitoring.html

3. 选择下列一项操作来处理 Auto Scaling 组中的所有现有 Amazon EC2 实例：

请执行此操作...如需...

从 Amazon EC2 API 对每个现有实例调用 MonitorInstances以启用详细监控。

保留现有实例

从 Auto Scaling API 对每个现有实例调用TerminateInstanceInAutoScalingGroup。Auto Scaling 将使用更新的启动配置创建启用了详细监控的替代实例。

终止现有实例

4. 如果您将 Amazon CloudWatch 警报与 Auto Scaling 组相关联，则从Amazon CloudWatch API 调用PutMetricAlarm以更新每个警报，这样可将警报的时间段值设为 60 秒。

激活 Auto Scaling 基本实例监控要创建使用基本监控而不是详细监控的新 Auto Scaling 组，请将新 Auto Scaling 组与InstanceMonitoring.Enabled标志设为 false的启动配置相关联。如果使用命令行工具，可使用--monitoring-disabled选项创建启动配置。

将现有 Auto Scaling 组切换到基本实例监控

1. 创建一个已禁用 InstanceMonitoring.Enabled标志的启动配置。如果使用命令行工具，可使用--monitoring-disabled选项创建启动配置。

2. 如果之前已经通过调用 EnableMetricsCollection启用了组指标，则对 Auto Scaling 组调用DisableMetricsCollection以禁止收集所有组指标。有关更多信息，请参阅 the section called“Auto Scaling 组支持” (p. 82)。

3. 使用上一步中创建的启动配置调用UpdateAutoScalingGroup以更新AutoScaling组。AutoScaling将对其所创建的新实例禁用详细监控。

4. 选择下列一项操作来处理 Auto Scaling 组中的所有现有 Amazon EC2 实例：

请执行此操作...如需...

从 Amazon EC2 API 对每个现有实例调用 UnmonitorInstances以禁用详细监控。

保留现有实例

从 Auto Scaling API 对每个现有实例调用TerminateInstanceInAutoScalingGroup。Auto Scaling 将使用更新的启动配置创建禁用了详细监控的替代实例。

终止现有实例

5. 如果您将 Amazon CloudWatch 警报与 Auto Scaling 组相关联，则从Amazon CloudWatch API 调用PutMetricAlarm以更新每个警报，这样可将警报的时间段值设为 300 秒。

Important

如果不将警报更新到匹配5分钟数据聚合，则警报将继续每分钟检查统计数据并可能每5分钟有 4 分钟找不到任何可用的数据。

有关 Amazon EC2 实例的实例指标的更多信息，请参阅 the section called “Amazon Elastic ComputeCloud 维度与指标” (p. 88)。


Amazon CloudWatch 开发人员指南Auto Scaling 实例支持

Auto Scaling 组支持组指标是Auto Scaling组发送到Amazon CloudWatch的指标，用于描述该组而非其实例。如果启用组指标，则AutoScaling每隔一分钟将聚合数据发送到AmazonCloudWatch一次。如果禁用组指标，则AutoScaling 不会将任何组指标数据发送到 Amazon CloudWatch。

启用组指标

1. 通过在 Auto Scaling 组的启动配置中设置 InstanceMonitoring.Enabled标志，可以为 AutoScaling 组启用详细实例监控。有关更多信息，请参阅 Auto Scaling Instance Support (p. 80)。

2. 调用 EnableMetricsCollection，它是 Auto Scaling 查询 API 的一部分。也可以使用等效的as-enable-metrics-collection命令，它是 Auto Scaling 命令行工具的一部分。

Auto Scaling 组指标表可以单独启用或禁用下列的每个指标。

描述指标

Auto Scaling 组的最小大小。GroupMinSize

Auto Scaling 组的最大大小。GroupMaxSize

Auto Scaling 组试图维护的实例数量。GroupDesiredCapacity

作为AutoScaling组的一部分运行的实例数量。该指标不包括处于挂起或终止状态的实例。

GroupInServiceInstances

处于挂起状态的实例数量。挂起的实例尚不可用。该指标不包括处于可用状态或终止状态的实例。

GroupPendingInstances

正处于终止过程中的实例的数量。该指标不包括处于可用状态或挂起状态的实例。

GroupTerminatingInstances

Auto Scaling组中的实例总数。该指标用于标识处于可用状态、挂起状态和终止状态的实例的数量。

GroupTotalInstances

Auto Scaling 组指标的维度Auto Scaling 发送到Amazon CloudWatch 的唯一维度是Auto Scaling 组的名称。这表示所有可用统计数据会通过 Auto Scaling 组名称进行筛选。

Amazon DynamoDB 维度与指标下面列出了 Amazon DynamoDB 发送到 Amazon CloudWatch 的指标和维度。有关如何监控 AmazonDynamoDB 的更多信息，请参阅 Amazon DynamoDB 开发人员指南中的使用 Amazon CloudWatch 监控 Amazon DynamoDB 表。

Amazon DynamoDB 维度与指标Amazon DynamoDB 中包含以下指标。请注意，仅当指标具有非零值时，Amazon DynamoDB 才会将指标发送到 Amazon CloudWatch。例如，只要请求生成 HTTP 400 错误代码，UserErrors指标就会增加；如果在特定时期内没有请求导致 400 代码，UserErrors的指标将不会显示。


Amazon CloudWatch 开发人员指南Auto Scaling 组支持



Note

并非所有统计数据（如 Average或 Sum）都适用于每个指标。但是，所有这些值均可通过控制台、API 和所有服务的命令行客户端获得。在下表中，每一个指标都有一个适用于该指标的有效统计数据列表。

例如，Amazon CloudWatch 可对每次 Amazon DynamoDB 请求被拒绝的事件进行监控（ThrottledRequests指标）。它会将该事件标记为一个发生事件。如果该请求重试后再次被拒绝，则 Amazon CloudWatch 也会将第二个事件标记为一个发生事件。当前，Sum统计数据的值为 2。但是，如果请求在指定时间段内被阻止（一次或多次），则 Average指标的ThrottledRequests统计数据始终为 1。对于 ThrottledRequests指标，可使用列出的有效统计数据（Sum 或 SampleCount）来查看 ThrottledRequests在指定时间段的趋势。

描述指标

指定时间段内成功请求的数量。默认情况下，SuccessfulRequestLatency提供成功调用所需的时间。您可以看到随时间推移的 Minimum、Maximum 或 Average的统计数据。

Note

CloudWatch 还提供了 SampleCount 统计数据：在某个样本时间段的成功调用的总数。

视图（命名空间）：AWS/DynamoDB, TableName,Operation

单位：毫秒（或 SampleCount 计数）

有效统计数据：Minimum、Maximum、Average、SampleCount

SuccessfulRequestLatency

在指定时间段内生成 400 状态代码（可能表示客户端错误）响应的请求的数量。

视图（命名空间）：All Metrics

单位：数量

有效统计数据：Sum、SampleCount

UserErrors

在指定时间段内生成 500 状态代码（可能表示服务器错误）响应的请求的数量。

视图（命名空间）：AWS/DynamoDB, TableName

单位：数量


SystemErrors


Amazon CloudWatch 开发人员指南Amazon DynamoDB 维度与指标

描述指标

在指定时间段内超出预配置吞吐量限制的用户请求的数量。

如果请求中的任何活动超过预配置的吞吐量上限，ThrottledRequests会增加 1。例如，如果您在具有全球二级索引的表中更新项目，则会发生多个事件 – 对表的写入以及对每个索引的写入。如果这些事件中的一个或多个被阻止，ThrottledRequests会增加 1。

要深入了解哪个事件在阻止请求，请将ThrottledRequests和表及其索引的 ReadThrottleEvents与WriteThrottleEvents进行对比。


单位：数量


ThrottledRequests

在指定时间段内超出预配置吞吐量限制的读取事件的数量。

单个API请求可能会导致多个事件。例如，读取10个项目的BatchGetItem会作为十个GetItem事件进行处理。对于每个事件，如果该事件被阻止，ReadThrottleEvents会增加1。除非全部十个 GetItem事件都被阻止，否则整个BatchGetItem的 ThrottledRequests指标不会增加。

TableName维度会针对表（不针对任何全球二级索引）返回ReadThrottleEvents。要查看全球二级索引的ReadThrottleEvents，您必须指定 TableName和GlobalSecondaryIndex。

视图（命名空间）：AWS/DynamoDB, TableName,GlobalSecondaryIndexName

单位：数量


ReadThrottleEvents

在指定时间段内超出预配置吞吐量限制的写入事件的数量。

单个 API 请求可能会导致多个事件。例如，一个具有三个全球二级索引的表的 PutItem请求会导致四个事件发生 –表的写入，以及三个索引中每个索引的写入。对于每个事件，如果被阻止，WriteThrottleEvents指标会增加 1。如果任一事件被阻止，则 ThrottledRequests也会增加 1。

TableName维度会针对表（不针对任何全球二级索引）返回WriteThrottleEvents。要查看全球二级索引的WriteThrottleEvents，您必须指定 TableName和GlobalSecondaryIndex。


单位：数量


WriteThrottleEvents



描述指标

表或全球二级索引的预配置的读取容量单位数。TableName维度会针对表（不针对任何全球二级索引）返回ProvisionedReadCapacityUnits。要查看全球二级索引的 ProvisionedReadCapacityUnits，您必须指定TableName和 GlobalSecondaryIndex。


单位：数量

有效统计数据：Minimum、Maximum、Average、Sum

ProvisionedReadCapacityUnits

表或全球二级索引的预配置的写入容量单位数

TableName维度会针对表（不针对任何全球二级索引）返回ProvisionedWriteCapacityUnits。要查看全球二级索引的 ProvisionedWriteCapacityUnits，您必须指定TableName和 GlobalSecondaryIndex。


单位：数量


ProvisionedWriteCapacityUnits

在指定时间段内使用的读取容量单位数，因此您可以跟踪预配置吞吐量使用了多少。您可以检索表及其所有全球二级索引或特定全球二级索引的总占用读取容量。有关更多信息，请参阅Amazon DynamoDB 中预配置的吞吐量。

Note

Sum 值可用于计算预配置的吞吐量。例如，可以获取 5 分钟时间段的 Sum 值。将 Sum 值除以 5 分钟所含的秒数 (300)，可以获得每秒ConsumedReadCapacityUnits 的平均值。您可以将计算出的值与您提供给 Amazon DynamoDB 的预配置吞吐量值进行比较。

视图（命名空间）：AWS/DynamoDB,TableName,GlobalSecondaryIndexName

单位：数量


ConsumedReadCapacityUnits



http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithDDTables.html#ProvisionedThroughput

描述指标

在指定时间段内使用的写入容量单位数，因此您可以跟踪预配置吞吐量使用了多少。您可以检索表及其所有全球二级索引或特定全球二级索引的总占用写入容量。有关更多信息，请参阅Amazon DynamoDB 中预配置的吞吐量。

Note

Sum 值可用于计算预配置的吞吐量。例如，可以获取 5 分钟时间段的 Sum 值。将 Sum 值除以 5 分钟所含的秒数 (300)，可以获得每秒ConsumedWriteCapacityUnits 的平均值。您可以将计算出的值与您提供给 Amazon DynamoDB 的预配置吞吐量值进行比较。


单位：数量


ConsumedWriteCapacityUnits

扫描或查询操作返回的项目数。


单位：数量

有效统计数据：Minimum、Maximum、Average、SampleCount、Sum

ReturnedItemCount

Amazon DynamoDB 指标的维度Amazon DynamoDB 的指标由账户、表名、全球二级索引名称或操作进行限定。您可以使用 AmazonCloudWatch 控制台按下表中的任意维度对 Amazon DynamoDB 数据进行筛选。

描述维度

该维度会将您请求的数据限定为特定表。该值可以是当前账户的任何表名。

TableName

该维度会将您请求的数据限定为表上的全球二级索引。如果您要指定GlobalSecondaryIndexName，还必须指定 TableName。

GlobalSecondaryIndexName


Amazon CloudWatch 开发人员指南Amazon DynamoDB 指标的维度

http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithDDTables.html#ProvisionedThroughput

描述维度

操作与 Amazon DynamoDB 服务 API 对应，可以是以下其中一项：

• PutItem

• DeleteItem

• UpdateItem

• GetItem

• BatchGetItem

• Scan

• Query

有关当前 Amazon DynamoDB 服务 API 中的所有操作，请参阅Amazon DynamoDB 中的操作。

Operation

Amazon EBS 维度与指标Amazon Elastic Block Store (Amazon EBS)可将若干指标的数据点发送到Amazon CloudWatch。标准装载的 Amazon EBS 卷会向 Amazon CloudWatch 自动发送 5 分钟指标。预配置的 IOPS 卷会向 AmazonCloudWatch 自动发送一分钟指标。有关如何监控 Amazon EBS 的更多信息，请参阅 Amazon ElasticCompute Cloud 用户指南中的监控您的卷状态。

Amazon EBS 指标您可以使用 Amazon CloudWatch GetMetricStatistics API 来获取下表中列出的任何 Amazon EBS卷指标。类似的指标在表中归为一组，前两行的指标也可供 Amazon EC2 实例上的本地存储使用。

描述指标

在指定时间传输的总字节数。卷处于活动状态时，数据仅报告给 AmazonCloudWatch。如果卷处于空闲状态，则不会向 Amazon CloudWatch 报告任何数据。

单位：字节

VolumeReadBytes

VolumeWriteBytes

在指定时间的 I/O 操作总数。

Note

要计算该周期的每秒平均 I/O 操作数 (IOPS)，请将该周期的总操作数除以总秒数。

单位：数量

VolumeReadOps

VolumeWriteOps

指定时间段中所有操作耗费的总秒数。如果同时提交多个请求，该总数可能大于时间段长度。例如，5 分钟（300 秒）内：若该时间段内完成了 700 个操作，每个操作耗时 1 秒，数值就会是 700 秒。

单位：秒

VolumeTotalReadTime

VolumeTotalWriteTime

未提交读取或写入操作的指定时间段中的总秒数。

单位：秒

VolumeIdleTime


Amazon CloudWatch 开发人员指南Amazon EBS 维度与指标

http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/operationlist.html

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-volume-status.html

描述指标

指定时间段中等待完成的读取和写入操作请求的数量。

单位：数量

VolumeQueueLength

仅用于预配置的 IOPS 卷。每秒传输的 I/O 操作数 (IOPS) 在为 EBS 卷预配置的总 IOPS 中所占的百分比。预配置的 IOPS 卷在给定一年中 99.9% 的时间传送 10% 以内的预配置 IOPS 性能。

Note

写入过程中，如果一分钟内没有其他待处理的I/O请求，指标值就会是 100%。另外，卷的 I/O 性能可能由于您已执行的操作而暂时降低（例如：在使用高峰期创建卷的快照、在非 EBS 优化的实例上运行卷，首次访问您卷上的数据）。

单位：百分比

VolumeThroughputPercentage

仅用于预配置的 IOPS 卷。指定时间段内使用的读取和写入操作总数。

单位：数量

VolumeConsumedReadWriteOps

Amazon EBS 指标的维度Amazon EBS发送到Amazon CloudWatch 的唯一维度是卷 ID。这表示所有可用统计数据会通过卷 ID进行筛选。

Amazon Elastic Compute Cloud 维度与指标本部分讨论Amazon Elastic Compute Cloud (Amazon EC2)发送到Amazon CloudWatch的指标和维度，并介绍如何对 EC2 实例启用详细（1 分钟）监控。有关 Auto Scaling 组指标（与 Auto Scaling 组中的Amazon EC2 实例相关）的信息，请参阅 Auto Scaling 维度与指标 (p. 80)。

Amazon CloudWatch 默认对 Amazon EC2 提供基本监控（5 分钟）。要对 Amazon EC2 实例进行详细监控，必须先启用详细监控。有关如何监控Amazon EC2的更多信息，请参阅Amazon Elastic ComputeCloud 用户指南中的使用 Amazon CloudWatch 监控您的实例。

Topics• Amazon EC2 指标 (p. 88)• Amazon EC2 指标的维度 (p. 90)

Amazon EC2 指标下列指标在每个 EC2 实例中都可以使用。

描述指标

当前正在实例上使用的已分配 EC2 计算单位的百分率。该指标确认在选定实例上运行一个应用程序需要的处理能力。

单位：百分比

CPUUtilization


Amazon CloudWatch 开发人员指南Amazon EBS 指标的维度

http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-cloudwatch.html

描述指标

从可供实例使用的所有临时磁盘已完成的读取操作（如果您的实例使用 Amazon EBS，请参见 Amazon EBS 指标 (p. 87)）。

该指标确认应用程序读取磁盘的速率。它可以用来确定应用程序从硬盘读取数据的速度。

单位：数量

DiskReadOps

对可供实例使用的所有临时磁盘已完成的写入操作（如果您的实例使用 Amazon EBS，请参见 Amazon EBS 指标 (p. 87)）。

该指标确认应用程序写入硬盘的速率。它可以用来确定应用程序向硬盘保存数据的速度。

单位：数量

DiskWriteOps

从可供实例使用的所有临时磁盘读取的字节数（如果您的实例使用Amazon EBS，请参见 Amazon EBS 指标 (p. 87)）。

该指标用来确定应用程序从实例的硬盘读取的数据量。它可以用来确定应用程序的速度。

单位：字节

DiskReadBytes

向可供实例使用的所有临时磁盘写入的字节数（如果您的实例使用Amazon EBS，请参见 Amazon EBS 指标 (p. 87)）。

该指标用来确定应用程序向实例的硬盘写入的数据量。它可以用来确定应用程序的速度。

单位：字节

DiskWriteBytes

实例在所有网络接口上收到的字节数。该指标确认单个实例上向应用程序传入的网络流量。

单位：字节

NetworkIn

实例在所有网络接口上发送的字节数。该指标确认单个实例上向应用程序传出的网络流量。

单位：字节

NetworkOut

报告两种状况检查之一是否失败的 StatusCheckFailed_Instance 和StatusCheckFailed_System 组合。该指标的值为 0（零）或者 1（一）。“零”表示状况检查已通过。“一”表示状况检查失败。

Note

状况检查指标每1分钟可用一次。对于新启动的实例，状况检查指标仅在实例已完成了初始化状态后可用。状况检查指标将在运行状态中的几分钟之内可用。

单位：数量

StatusCheckFailed


Amazon CloudWatch 开发人员指南Amazon EC2 指标

描述指标

报告实例在上个 1 分钟内是否通过了 EC2 实例状况检查。该指标的值为0（零）或者1（一）。“零”表示状况检查已通过。“一”表示状况检查失败。

Note


单位：数量

StatusCheckFailed_Instance

报告实例在上一分钟内是否通过了 EC2 系统状况检查。该指标的值为0（零）或者1（一）。“零”表示状况检查已通过。“一”表示状况检查失败。

Note


单位：数量

StatusCheckFailed_System

新 EC2 实例的 Amazon CloudWatch 数据通常在查询中请求的第一个周期（聚合期）结束后的 1 分钟内便可供使用。可以使用 Period 参数设置周期，即用于聚合统计数据的时间段。有关周期的更多信息，请参阅时间段 (p. 7)。

可以对 EC2 实例使用当前可用的维度（例如 ImageID或 InstanceType）来细化返回的指标。有关可用于 EC2 的维度的信息，请参阅 Amazon EC2 指标的维度 (p. 90)。

Amazon EC2 指标的维度如果使用详细监控，可以使用下表中的任意维度筛选 EC2 实例数据。

描述维度

该维度筛选您为指定容量组中的所有实例请求的数据。如果使用AutoScaling服务，AutoScalingGroup即您定义的实例集合。当实例在上述AutoScalingGroup中时，该维度仅供EC2指标使用。可供启用了详细或基本监控的实例使用。

AutoScalingGroupName

该维度筛选您为运行此 EC2 亚马逊系统映像 (AMI) 的所有实例请求的数据。可供启用了详细监控功能的实例使用。

ImageId

该维度筛选您仅为已识别实例请求的数据。这样有助于您精确定位要对其监控数据的确切实例。可供启用了详细监控功能的实例使用。

InstanceId

该维度筛选您为以这一指定实例类型运行的所有实例请求的数据。这样有助于您按运行的实例类型给数据分类。例如，您可以比较m1.small 实例和 m1.large 实例的数据，以确定哪一个对您的应用程序具有更好的商业价值。可供启用了详细监控功能的实例使用。

InstanceType


Amazon CloudWatch 开发人员指南Amazon EC2 指标的维度

Elastic Load Balancing 维度与指标Topics• Elastic Load Balancing 指标 (p. 91)• Elastic Load Balancing 指标的维度 (p. 92)

本部分讨论 Elastic Load Balancing 发送到 Amazon CloudWatch 的指标和维度。Amazon CloudWatch默认情况下对Elastic Load Balancing进行详细监控。与Amazon EC2不同，您无需专门启用详细监控。有关如何监控 Elastic Load Balancing 的更多信息，请参阅 Elastic Load Balancing 开发人员指南中的使用 Amazon CloudWatch 监控您的负载均衡器。

Note

Elastic Load Balancing仅当请求流经负载均衡器时才会发送Amazon CloudWatch指标。ElasticLoad Balancing 以 60 秒的间隔衡量和发送该负载均衡器的指标。

Elastic Load Balancing 指标下列 Elastic Load Balancing 指标可从 Amazon CloudWatch 获得。

Elastic Load Balancing 仅报告请求何时流经负载均衡器。如果某一指定指标没有请求或数据，该指标便不会被上报到CloudWatch。如果请求流经负载均衡器，Elastic Load Balancing 将以 60 秒的时间间隔度量和发送该负载均衡器的指标。注意：可通过 Amazon CloudWatch 获得的统计数据值（如 Min或 Count）并非始终适用于所有指标。但是，这些值均可通过控制台、API 和命令行界面 (CLI) 获得。对于每个指标，请留意所有 Elastic LoadBalancing 的首选统计数据，以跟踪有价值的信息。

描述指标

每个可用区域内运行状况良好的实例的计数。如果主机能够成功达到针对多次运行状况检查设定的阈值，则说明主机是健康的。运行状况检查失败次数超过不健康阈值的主机被认为是不健康的。首选统计数据： average

HealthyHostCount

每个可用区域内运行状况不佳的实例的计数。运行状况检查失败次数超过不健康阈值的主机被认为是不健康的。实例可能由于连接性问题、运行状况检查返回非200的响应（在HTTP或HTTPS运行状况检查的情况下）或者执行运行状况检查时超时而变得不健康。首选统计数据： average

UnhealthyHostCount

已接收并路由到后端实例的已完成请求的计数。首选统计数据： sum

RequestCount

衡量请求离开负载均衡器直至收到响应所用的时间（以秒为单位）。首选统计数据： average

Latency

当监听器配置为使用 HTTP 或 HTTPS 协议时，负载均衡器生成的 HTTP 4XX 客户端错误代码的计数。当请求出现格式错误或不完整时，就会生成客户端错误。首选统计数据： sum

HTTPCode_ELB_4XX


Amazon CloudWatch 开发人员指南Elastic Load Balancing 维度与指标



描述指标

当监听器配置为使用 HTTP 或 HTTPS 协议时，负载均衡器生成的 HTTP 5XX 服务器错误代码的计数。该指标不包含后端实例生成的响应。如果没有运行状况良好或注册到负载均衡器的后端实例，或者请求速率超过了实例或负载均衡器的容量，则会报告该指标。首选统计数据： sum

HTTPCode_ELB_5XX

后端实例生成的 HTTP 响应代码的计数。该指标不包含负载均衡器生成的响应代码。2XX 类状态代码代表操作成功。3XX 类状态代码表示用户代理需要操作。4XX 类状态代码代表客户端错误。5XX 类状态代码代表后端服务器错误。首选统计数据： sum

HTTPCode_Backend_2XX




负载均衡器和已注册实例之间建立失败的连接的计数。因为负载均衡器会在发生连接错误时重试，此计数会超出请求速率。首选统计数据： sum

BackendConnectionErrors

等待提交至已注册实例的请求总数的计数。首选统计数据： max

SurgeQueueLength

因为队列已满而被拒的请求总数的计数。首选统计数据： sum

SpilloverCount

Elastic Load Balancing 指标的维度可以对 Elastic Load Balancing 使用当前可用的维度来细化查询返回的指标。例如，可以使用HealthyHostCount 以及维度 LoadBalancerName 和 AvailabilityZone 以给定的时间段在指定的可用区域内获取指定负载均衡器背后正常运行的实例的平均数字。

Elastic Load Balancing 数据可以按照下表中显示的任何维度进行聚合。

描述维度

将指标数据限于连接到指定负载均衡器的 Amazon EC2 实例。LoadBalancerName

将指标数据限于指定可用区域中的负载均衡器。AvailabilityZone

Amazon Elastic MapReduce 维度与指标本部分讨论 Amazon Elastic MapReduce (Amazon EMR) 发送到 Amazon CloudWatch 的指标和维度。所有Amazon EMR任务流程每隔 5分钟自动发送一次指标。指标会存档两周。两周后，数据会被丢弃。有关如何监控 Amazon EMR 的更多信息，请参阅 Amazon Elastic MapReduce 开发人员指南中的使用Amazon CloudWatch 监控指标。

Amazon EMR 指标Amazon EMR 会向 Amazon CloudWatch 发送以下指标。


Amazon CloudWatch 开发人员指南Elastic Load Balancing 指标的维度



Note

AmazonEMR从cluster提取指标。如果无法连接到cluster，则在cluster再次变成可用状态之前将不会报告任何指标。

描述指标

等待分配的核心节点的数量。请求的所有核心节点可能不会立即可用；此指标报告挂起的请求。仅当对应的实例组存在时，才会报告此指标的数据点。

使用案例：监控cluster运行状况

单位：数量

CoreNodesPending

处于运行状态的核心节点的数量。仅当对应的实例组存在时，才会报告此指标的数据点。


单位：数量

CoreNodesRunning

最后一次备份是否失败。默认设置为 0，如果上一次备份尝试失败，则更新为 1。仅为 HBase cluster报告此指标。

使用案例：监控 HBase 备份

单位：数量

HBaseBackupFailed

完成上一次备份所需的时长。无论最后完成的备份成功或失败，都会设置此指标。进行备份的同时，此指标会返回自备份开始的分钟数。仅为 HBase cluster报告此指标。


单位：分钟

HBaseMostRecentBackupDuration

在您的集群上，自最后一次成功 HBase 备份开始计数的已用分钟数。仅为 HBase cluster报告此指标。


单位：分钟

HBaseTimeSinceLastSuccessfulBackup

从 HDFS 读取的字节数。

使用案例：分析cluster性能，监控cluster进度

单位：数量

HDFSBytesRead

写入 HDFS 的字节数。


单位：数量

HDFSBytesWritten

当前使用的 HDFS 存储的百分率。

使用案例：分析cluster性能

单位：百分比

HDFSUtilization


Amazon CloudWatch 开发人员指南Amazon EMR 指标

描述指标

指示cluster不再执行任务，但仍处于活动状态并会产生费用。如果没有任何任务和作业处于运行状态，则此指标设置为 1；否则设置为 0。系统每隔五分钟检查一次该值，值为 1 仅表示cluster在检查时处于空闲状态，并不表示它整个五分钟内都处于空闲状态。为避免误报，当多次连续5分钟检查获得的值均为1时，您应提出警报。例如，当该值在三十分钟或更长时间内都为1时，您应提出警报。

使用案例：监控cluster的性能

单位：数量

IsIdle

cluster中失败的任务数量。


单位：数量

JobsFailed

cluster中当前处于运行状态的任务数量。


单位：数量

JobsRunning

从 Hadoop 接收任务的数据节点的百分率。


单位：百分比

LiveDataNodes

处于运行状态的任务跟踪程序的百分率。


单位：百分比

LiveTaskTrackers

未使用的映射任务容量。该指标将计算为给定cluster的最大映射任务数与该cluster中当前运行的映射任务总数之差。


单位：数量

MapSlotsOpen

HDFS 在其中没有副本的数据块的数量。这些数据块可能已损坏。


单位：数量

MissingBlocks

未使用的缩减任务容量。该指标将计算为给定cluster的最大缩减任务容量与该cluster中当前运行的缩减任务数之差。


单位：数量

ReduceSlotsOpen



描述指标

每个作业的剩余映射任务的数量。如果您安装了调度程序并且有多个作业在运行，那么会生成多个图表。剩余映射任务是指未处于任何以下状态的任务：运行中、已终止或已完成。

使用案例：监控cluster进度

单位：数量

RemainingMapTasks

剩余映射任务的总数与集群中可用映射插槽总数之比。


单位：比率

RemainingMapTasksPerSlot

每个作业的剩余缩减任务的数量。如果您安装了调度程序并且有多个作业在运行，那么会生成多个图表。


单位：数量

RemainingReduceTasks

每个作业处于运行中的映射任务的数量。如果您安装了调度程序并且有多个作业在运行，那么会生成多个图表。


单位：数量

RunningMapTasks

每个作业处于运行中的缩减任务的数量。如果您安装了调度程序并且有多个作业在运行，那么会生成多个图表。


单位：数量

RunningReduceTasks

从 Amazon S3 读取的字节数。


单位：数量

S3BytesRead

写入 Amazon S3 的字节数。


单位：数量

S3BytesWritten

等待分配的核心节点的数量。请求的所有任务节点可能不会立即可用；此指标报告挂起的请求。仅当对应的实例组存在时，才会报告此指标的数据点。


单位：数量

TaskNodesPending



描述指标

处于运行状态的任务节点的数量。仅当对应的实例组存在时，才会报告此指标的数据点。


单位：数量

TaskNodesRunning

并发数据传输的总数。


单位：数量

TotalLoad

Amazon EMR 指标下列维度可用于 Amazon EMR。

描述维度

cluster的标识符。通过在 Amazon EMR 控制台中单击cluster，可以找到该值。其形式为 j-XXXXXXXXXXXXX。

任务流程 ID

cluster中任务的标识符。可以使用此标识符从返回自cluster的指标中筛选出那些适用于cluster中单个任务的指标。JobId的形式为 job_XXXXXXXXXXXX_XXXX。

任务 ID

Amazon RDS 维度与指标本部分讨论 Amazon Relational Database Service 发送到 Amazon CloudWatch 的指标和维度。AmazonCloudWatch 默认情况下对 Amazon RDS 进行详细监控。Amazon Relational Database Service 每隔一分钟发送一次每个活动数据库实例的指标。与 Amazon EC2 和 Auto Scaling 不同，您无需专门启用详细监控。有关如何监控 Amazon RDS 的更多信息，请参阅 Amazon Relational Database Service 用户指南中的监控数据库实例。

Topics• Amazon RDS 指标 (p. 96)• RDS 指标的维度 (p. 97)

Amazon RDS 指标Amazon Relational Database Service 中包含以下指标。

描述指标

主节点上的二进制日志所占的磁盘空间大小。

单位：字节

BinLogDiskUsage

CPU 使用百分率。

单位：百分比

CPUUtilization



http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Monitoring.html

描述指标

使用中的数据库连接数。

单位：数量

DatabaseConnections

等待访问磁盘的未完成 IO（读取/写入请求）的数量。

单位：数量

DiskQueueDepth

随机存取内存的可用大小。

单位：字节

FreeableMemory

可用存储空间的大小。

单位：字节

FreeStorageSpace

只读副本数据库实例落后于源数据库实例的时间量。

单位：秒

ReplicaLag

数据库实例上使用的交换空间的大小。

单位：字节

SwapUsage

每秒平均磁盘 I/O 操作数。

单位：计数/秒

ReadIOPS

每秒平均磁盘 I/O 操作数。

单位：计数/秒

WriteIOPS

每个磁盘 I/O 操作所需的平均时间。

单位：秒

ReadLatency

每个磁盘 I/O 操作所需的平均时间。

单位：秒

WriteLatency

每秒从磁盘读取的平均字节数。

单位：字节/秒

ReadThroughput

每秒写入磁盘的平均字节数。

单位：字节/秒

WriteThroughput

RDS 指标的维度可以按下表中的任意维度对 Amazon RDS 数据进行筛选。

描述维度

该维度筛选您为特定数据库实例请求的数据。DBInstanceIdentifier

该维度筛选您为数据库类中的所有实例请求的数据。例如，您可以聚合属于数据库类 db.m1.small的所有实例的指标。

DatabaseClass


Amazon CloudWatch 开发人员指南RDS 指标的维度

描述维度

该维度筛选您仅为已识别的引擎名称请求的数据。例如，您可以聚合具有引擎名称 mysql的所有实例的指标。

EngineName

Amazon Simple Notification Service 维度与指标Amazon Simple Notification Service 将若干指标的数据点发送到 Amazon CloudWatch。所有活动主题会自动向 Amazon CloudWatch 发送 5 分钟指标。详细监控或 1 分钟指标目前不适用于 Amazon SimpleNotification Service。每个主题在该主题的上一个活动（例如，任何 API 调用）之后保持活跃状态 6 小时。有关如何监控Amazon SNS的更多信息，请参阅Amazon Simple Notification Service 开发人员指南中的使用 Amazon CloudWatch 监控 Amazon SNS。

Amazon Simple Notification Service 指标此部分会讨论Amazon Simple Notification Service (Amazon SNS)发送到Amazon CloudWatch的指标。

描述指标

发布至主题的消息数量。

单位：数量

有效统计数据：总计

NumberOfMessagesPublished

发送至主题的消息大小。

单位：字节

有效统计数据：最小值、最大值、平均值和计数

PublishSize

成功传输至主题所有订阅的消息数量。

单位：数量


NumberOfNotificationsDelivered

未传输至主题订阅的所有通知尝试次数。

单位：数量


NumberOfNotificationsFailed

Amazon Simple Notification Service 指标的维度Amazon Simple Notification Service 会向 Amazon CloudWatch 发送以下维度。

描述维度

应用程序数据元过滤条件，表示某一应用和设备向一项支持的推送通知服务（如 APNS 和 GCM）进行了注册。

Application

应用程序和平台数据元过滤条件，其中，平台数据元针对的是支持的推送通知服务（如 APNS 和 GCM）。

Application,Platform


Amazon CloudWatch 开发人员指南Amazon Simple Notification Service 维度与指标


描述维度

针对推送通知服务（如APNS和GCM）的平台数据元的过滤条件。Platform

Amazon SNS 主题名称过滤条件。TopicName

Amazon SQS 维度与指标Amazon SQS 可将若干指标的数据点发送到 Amazon CloudWatch。所有活动队列会自动向 AmazonCloudWatch 发送 5 分钟指标。详细监控或 1 分钟指标目前不适用于 Amazon SQS。每个队列在该队列的上一个活动（例如，任何API 调用）之后保持活跃状态 6小时。有关如何监控Amazon SQS的更多信息，请参阅 Amazon Simple Queue Service 开发人员指南中的使用 Amazon CloudWatch 监控 AmazonSQS。

Amazon SQS 指标此部分会讨论 Amazon Simple Queue Service (Amazon SQS) 发送到 Amazon CloudWatch 的指标。

描述指标

添加到队列的消息数量。

单位：数量


NumberOfMessagesSent

添加到队列的消息大小。

单位：字节

有效统计数据：最小值、最大值、平均值和计数

SentMessageSize

调用 ReceiveMessage API 操作返回的消息数量。

单位：数量


NumberOfMessagesReceived

未返回消息的 ReceiveMessage API 调用数量。

单位：数量


NumberOfEmptyReceives

从队列删除的消息数量。

单位：数量


NumberOfMessagesDeleted


Amazon CloudWatch 开发人员指南Amazon SQS 维度与指标



描述指标

队列中延迟且无法立即读取的消息数量。如果队列被配置为延迟队列，或者使用了延迟参数来发送消息，则会出现这种情况。

单位：数量

有效统计数据：平均值

ApproximateNumberOfMessagesDelayed

可从队列取回的消息数量。

单位：数量


ApproximateNumberOfMessagesVisible

处于空中状态的消息的数量。如果消息已发送到客户端，但尚未删除或尚未到达其可见性窗口末尾，则消息被认为处于飞行状态。

单位：数量


ApproximateNumberOfMessagesNotVisible

Amazon SQS 指标的维度Amazon SQS 发送到 Amazon CloudWatch 的唯一维度是 QueueName。这表示所有可用统计信息会通过 QueueName 进行筛选。

AWS Storage Gateway 维度与指标AWS Storage Gateway 可将若干指标的数据点发送到 Amazon CloudWatch。所有活动队列会自动向Amazon CloudWatch 发送 5 分钟指标。详细监控或 1 分钟指标目前不适用于 AWS Storage Gateway。有关如何监控AWS Storage Gateway 的更多信息，请参阅AWS Storage Gateway 用户指南中的监控您的 AWS Storage Gateway。

AWS Storage Gateway 指标AWS Storage Gateway Service 中包含以下指标。

下表描述了可用来获取网关相关信息的 AWS Storage Gateway 指标。可指定每个指标的 GatewayId或GatewayName维度来查看网关的数据。请注意，这些指标是以 5 分钟为间隔衡量的。

描述指标

报告周期内网关中的所有卷从场内应用程序读取的总字节数。

通过该指标可以测量吞吐量，方法是选择 Sum统计数据并除以时间段。通过该指标可以测量操作速率 (IOPS)，方法是选择 Samples统计数据并将每个数据点除以时间段。

单位：字节

ReadBytes


Amazon CloudWatch 开发人员指南Amazon SQS 指标的维度



描述指标

报告周期内网关中所有卷写入场内应用程序的总字节数。


单位：字节

WriteBytes

报告周期内网关中所有卷从场内应用程序进行读取所耗费的总毫秒数。

将该指标与 Average统计数据结合使用可测量平均延迟。

单位：毫秒

ReadTime

报告周期内网关中所有卷从场内应用程序进行写入操作所耗费的总毫秒数。


单位：毫秒

WriteTime

等待写入AWS的字节数，网关中的所有卷在报告周期结束时采样所得。这些字节保存在网关的工作存储空间中。

单位：字节

QueuedWrites

网关在报告期间从 AWS 下载的总字节数。


单位：字节

CloudBytesDownloaded

网关在报告期间上传到 AWS 的总字节数。


单位：字节

CloudBytesUploaded

报告期间从 AWS 读取数据耗费的总毫秒数。


单位：毫秒

CloudDownloadLatency

网关的工作存储空间的百分使用率。样本在报告周期结束时采用。

单位：百分比

WorkingStoragePercentUsed

网关的工作存储所使用的总字节数。样本在报告周期结束时采用。

单位：字节

WorkingStorageUsed

网关的工作存储空间中未使用的总空间量。样本在报告周期结束时采用。

单位：字节

WorkingStorageFree


Amazon CloudWatch 开发人员指南AWS Storage Gateway 指标

下表描述了可用来获取存储卷相关信息的AWSStorage Gateway指标。可指定每个指标的 VolumeId维度来查看存储卷的数据。

描述指标

报告周期内从场内应用程序读取的总字节数。


单位：字节

ReadBytes

报告周期内写入到场内应用程序的总字节数。


单位：字节

WriteBytes

报告周期内从场内应用程序进行读取所耗费的总毫秒数。


单位：毫秒

ReadTime

报告周期内从场内应用程序进行写入所耗费的总毫秒数。


单位：毫秒

WriteTime

等待写入到 AWS 的字节数，采样于报告周期结束时。

单位：字节

QueuedWrites

缓存传送的应用程序读取率。该指标仅适用网关缓存卷的设置。样本在报告周期结束时采用。

单位：百分比。

CacheHitPercent

网关的缓存存储空间的百分使用率。该指标仅适用网关缓存卷的设置。样本在报告周期结束时采用。

单位：百分比

CachePercentUsed

尚未持续到 AWS 的网关缓存百分比。该指标仅适用网关缓存卷的设置。样本在报告周期结束时采用。

单位：百分比

CachePercentDirty

网关的上传缓冲区未使用字节的总量。样本在报告周期结束时采用。

单位：字节

UploadBufferFree

网关上传缓冲区的使用率。样本在报告周期结束时采用。

单位：百分比

UploadBufferPercentUsed


Amazon CloudWatch 开发人员指南AWS Storage Gateway 指标

描述指标

网关的上传缓冲区正在使用的总字节数。样本在报告周期结束时采用。

单位：字节

UploadBufferUsed

以字节为单位的缓存总大小。该指标仅适用网关缓存卷的设置。样本在报告周期结束时采用。

单位：字节

TotalCacheSize

网关上传缓冲区的使用率。样本在报告周期结束时采用。

Note

工作存储空间仅适用于网关存储卷设置。上传缓冲区适用于网关存储和网关缓存卷设置。如果您要使用两种类型的网关设置，可能会发现仅使用相应的上传缓冲区指标 UploadBufferPercentUsed更为方便。

单位：百分比

WorkingStoragePercentageUsed

AWS Storage Gateway 指标的维度AWS Storage Gateway 服务的 Amazon CloudWatch 命名空间为 AWS/StorageGateway。数据在 5 分钟期间内自动可用，无需收费。

描述维度

这些维度会将您请求的数据筛选为特定于网关的指标。您可以通过网关的 GatewayId或 GatewayName来标识要工作的网关。但请注意，如果在您需要查看指标的这段时间范围内，网关的名称已更改，则您应使用 GatewayId。

网关的吞吐量和延迟数据基于网关的所有卷。有关使用网关指标的信息，请参阅测量网关与 AWS 之间的性能。

GatewayId,GatewayName

该维度会将您请求的数据限定为特定于卷的指标。通过卷的VolumeId标识要使用的存储卷。有关使用卷指标的信息，请参阅测量应用程序与网关之间的性能。

VolumeId


Amazon CloudWatch 开发人员指南AWS Storage Gateway 指标的维度

http://docs.aws.amazon.com/storagegateway/latest/userguide/PerfGatewayAWS.html

http://docs.aws.amazon.com/storagegateway/latest/userguide/PerfAppGateway.html

http://docs.aws.amazon.com/storagegateway/latest/userguide/PerfAppGateway.html

AmazonCloudWatch命令行界面参考

AWS 提供两组支持 Amazon CloudWatch 的命令行工具。本部分介绍 Amazon CloudWatch 命令行界面(CLI)。有关下载和安装 CLI 的更多信息，请参阅设置命令行界面 (p. 13)。

还可使用 AWS 命令行界面在Windows、Mac 和 Linux 上控制和自动化 Amazon CloudWatch。如果您喜欢在 PowerShell 环境中编写脚本，我们还提供了适用于Windows PowerShell 的 AWS 工具。

Topics• mon-cmd (p. 104)• mon-delete-alarms (p. 106)• mon-describe-alarm-history (p. 110)• mon-describe-alarms (p. 115)• mon-describe-alarms-for-metric (p. 120)• mon-disable-alarm-actions (p. 126)• mon-enable-alarm-actions (p. 130)• mon-get-stats (p. 134)• mon-list-metrics (p. 142)• mon-put-data (p. 148)• mon-put-metric-alarm (p. 154)• mon-set-alarm-state (p. 162)• mon-version (p. 166)• CLI 示例 (p. 167)

mon-cmd描述列出所有其他 Amazon CloudWatch 命令。有关特定命令的帮助，请键入 <commandname> --help。

语法mon-cmd


Amazon CloudWatch 开发人员指南mon-cmd

http://aws.amazon.com/cli/

http://aws.amazon.com/powershell/

输出此命令列出表中的所有 Amazon CloudWatch 命令。

Amazon CloudWatch CLI 在 stderr 上显示错误。

示例示例请求此示例列出所有 Amazon CloudWatch 命令。

PROMPT> mon-cmd

Command Name Description

------------ -----------

help mon-delete-alarms Delete alarms.

mon-describe-alarm-history Show the history of alarm transitions and actions taken. mon-describe-alarms List alarms and show detailed alarm config uration. mon-describe-alarms-for-metric Show alarms for a given metric. mon-disable-alarm-actions Disable all actions for a given alarm.

mon-enable-alarm-actions Enable all actions for a given alarm.

mon-get-stats Get metric statistics.

mon-list-metrics List user's metrics. mon-put-data Put metric data.mon-put-metric-alarm Create a new alarm or update an existing one. mon-set-alarm-state Manually set the state of an alarm.

mon-version Prints the version of the CLI tool and API.

For help on a specific command, type '<commandname> --help'

相关主题下载• 设置命令行界面 (p. 13)

相关命令• mon-version (p. 166)


Amazon CloudWatch 开发人员指南输出

mon-delete-alarms描述删除指定警报。

语法mon-delete-alarms [AlarmNames [AlarmNames ...]] [Common Options]

选项必需描述姓名

是要删除的警报的名称，用空格分隔。还可以使用 --alarm-name设置此值。

类型：参数

有效值：警报的名称，长度必须在1到 255个字符之间。

默认：无

AlarmNames AlarmNames

否删除警报，不提示您进行确认。默认情况下，mon-delete-alarms命令在删除警报前提示您进行确认。

类型：标志

有效值：无

默认：在删除每个警报前会提示您。

-f, --force

常用选项描述名称

指定带有 AWS 证书的文件的位置。您可以使用环境变量AWS_CREDENTIAL_FILE设置此值。如果您定义了该环境变量或提供了证书文件的路径，则文件必须存在，否则请求将失败。必须使用您的访问密钥 ID 和私有访问密钥签署所有Amazon CloudWatch 请求。

类型：字符串

有效值：包含访问密钥 ID 和私有访问密钥的文件的有效路径。

默认值：使用环境变量AWS_CREDENTIAL_FILE（如果已设置）。

--aws-credential-file VALUE


Amazon CloudWatch 开发人员指南mon-delete-alarms

描述名称

指定用于签署请求的EC2证书文件的位置。您可以使用环境变量 EC2_CERT指定此值。

类型：字符串

有效值：Amazon EC2 或 AWS Identity and AccessManagement 提供的 PEM 文件的有效文件路径。

默认值：使用环境变量 EC2_CERT（如果已设置）。

-C, --ec2-cert-file-path VALUE

指定连接超时 VALUE（以秒为单位）。

类型：整数

有效值：任何正数。

默认值：30

--connection-timeout VALUE

显示带分隔符（长整型）的结果时使用的分隔符。

类型：字符串

有效值：任何字符串。

默认值：逗号 (,)

--delimiter VALUE

如果您正在显示表格式或带分隔符的结果，那么其将算入列标题。如果您正在显示 xml 结果，那么其将通过服务请求返回 HTTP 标题（如适用）。

类型：标志

有效值：当标头存在时，显示标头。

默认值：默认情况下，--headers选项处于关闭状态。

--headers

指定将与私有密钥一起使用的 VALUE 的访问密钥 ID，用于签署请求。此参数必须与私有密钥一起使用，否则该选项将被忽略。对 Amazon CloudWatch 的所有请求都必须经过签署，否则请求将被拒绝。

类型：字符串

有效值：有效的访问密钥 ID。

默认值：无

-I, --access-key-id VALUE


Amazon CloudWatch 开发人员指南常用选项

描述名称

在用于签署请求的文件 VALUE 中指定一个私有密钥。使用公有/私有密钥会导致CLI使用SOAP。将使用公有证书和私有密钥签署请求。此参数必须与 EC2_CERT一起使用，否则该值将被忽略。如果已设置环境变量，将使用环境变量EC2_PRIVATE_KEY的值，且不会指定此选项。如果已设置环境变量 AWS_CREDENTIAL_FILE，或使用了--aws-credentials-file，此选项将被忽略。对AmazonCloudWatch 的所有请求都必须经过签署，否则请求将被拒绝。

类型：字符串

有效值：有效 ASN.1 私有密钥的路径。

默认值：无

-K, --ec2-private-key-file-pathVALUE

指定将请求定向到的地区。您可以使用环境变量EC2_REGION指定该值。此地区用于创建调用 Amazon CloudWatch 的URL，且必须是有效的AmazonWebServices (AWS)地区。

类型：字符串

有效值：任何 AWS 地区，例如 us-east-1。

默认值：us-east-1（除非设置了EC2_REGION环境变量）。

--region VALUE

指定将与访问密钥 ID一起使用的VALUE的私有密钥，用于签署请求。此参数必须与--access-key-id一起使用，否则此选项将被忽略。

类型：字符串

有效值：您的访问密钥 ID。

默认值：无

S, --secret-key VALUE

使用 (nil) 作为占字符显示空白字段，表示未请求该数据。

类型：标志

有效值：无

默认值：默认情况下不显示空白字段。

--show-empty-fields

显示 CLI 用于调用 AWS 的 URL。

类型：标志

有效值：无

默认值：false

--show-request



描述名称

指定显示结果的方式：表格式、带分隔符（长整型）、XML或无输出（秘密型）。--show-table在固定列宽的表格中显示数据子集；--show-long显示由字符进行分隔的所有返回值；--show-xml是来自服务的原始返回值；--quiet隐藏所有标准输出。所有选项相互排斥，优先级顺序为--show-table、--show-long、--show-xml和-–quiet。

类型：标志

有效值：无

默认值：--show-table

--show-table, --show-long,--show-xml, --quiet

指定用于联系Amazon CloudWatch 的 URL。您可以使用环境变量 AWS_CLOUDWATCH_URL设置此值。此值将与--region一起使用，用于创建预期 URL。该选项将使用VALUE 覆盖服务调用 URL。

类型：字符串

有效值：有效的 HTTP 或 HTTPS URL。

默认值：使用 AWS_CLOUDWATCH_URL中指定的值（如果已设置）。

-U, --url VALUE

输出此命令删除警报。


示例示例请求此示例删除名为 my-alarm 的警报。

PROMPT> mon-delete-alarms --alarm-name my-alarm

示例请求此示例删除多个警报。

PROMPT> mon-delete-alarms --alarm-name my-alarm1 my-alarm2 my-alarm3




相关操作• 删除警报

相关评论• mon-put-metric-alarm (p. 154)• mon-disable-alarm-actions (p. 126)• mon-enable-alarm-actions (p. 130)

mon-describe-alarm-history描述检索指定警报的历史记录。您可以按日期范围或项目类型筛选警报。如果不指定警报名称，AmazonCloudWatch 会返回所有警报的历史记录。

Note

Amazon CloudWatch 将活动警报和已删除警报的历史记录保存两个星期。

语法mon-describe-alarm-history [AlarmNames [AlarmNames ...]] [--end-date value][--history-item-type value] [--start-date value] [Common Options]


否您要查看其历史记录的警报的名称，用空格分隔。如果不指定警报名称，此命令会返回所有警报的历史记录。还可以使用--alarm-name设置此值。

类型：参数

有效值：长度在1到 255个字符之间的任何字符串。

默认：无

AlarmName AlarmNames


Amazon CloudWatch 开发人员指南相关主题

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DeleteAlarms.html

必需描述姓名

否历史记录的日期范围内的结束日期。

类型：日期

有效值：YYYY-MM-DD 格式的日期。

默认：当前日期。

--end-date VALUE

否要检索的历史记录项的类型。默认情况下，将返回所有类型。

类型：枚举

有效值：ConfigurationUpdate、StateUpdate或 Action

默认：返回所有类型。

--history-item-type VALUE

否历史记录的日期范围内的开始日期。默认情况下，它会延伸到所有可用历史记录。

类型：日期

有效值：YYYY-MM-DD 格式的日期。

默认：所有可用历史记录。

--start-date VALUE



类型：字符串





类型：字符串






描述名称


类型：整数


默认值：30



类型：字符串



--delimiter VALUE


类型：标志



--headers


类型：字符串


默认值：无



类型：字符串


默认值：无




描述名称


类型：字符串



--region VALUE


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无





描述名称


类型：字符串



-U, --url VALUE

输出此命令将返回包含以下内容的表格：

• 警报 - 警报名称。• 时间戳 - 时间戳。• 类型 - 事件类型，ConfigurationUpdate、StateUpdate 和 Action 之一。• 摘要 - 历史记录事件的人类可读汇总。• 数据 - 有关事件的机器可读 JSON 格式的详细数据。该列仅在 --show-long 视图中显示。


示例示例请求此示例描述 my-alarm 警报的所有历史记录项。

PROMPT> mon-describe-alarm-history--alarm-name my-alarm --headers

This is an example output of this command.

ALARM TIMESTAMP TYPE SUMMARYmy-alarm 2013-05-07T18:46:16.121Z Action Published a notification to arn:aws:sns:...my-alarm 2013-05-07T18:46:16.118Z StateUpdate Alarm updated from INSUFFICIENT_DATA to OKmy-alarm 2013-05-07T18:46:07.362Z ConfigurationUpdate Alarm "my-alarm" created




相关操作• DescribeAlarmHistory

相关评论• mon-describe-alarms (p. 115)• mon-describe-alarms-for-metric (p. 120)

mon-describe-alarms描述提供指定警报的信息。如果不指定警报名称，此命令会返回有关所有警报的信息。只能使用警报名称前缀、警报状态或操作前缀检索警报。

语法mon-describe-alarms [AlarmNames [AlarmNames ...]] [--action-prefix value][--alarm-name-prefix value] [--state-value value] [Common Options]


否警报的名称。还可以使用--alarm-name设置此值。您可以多次指定该选项。

类型：参数

有效值：现有警报名称，否则不会返回任何响应。

默认：n/a，默认情况下显示所有警报。


否操作名称的前缀。

类型：参数

有效值：现有操作名称的前缀，采用 ARN 格式。

默认：n/a，默认情况下显示第一个操作。

--action-prefix VALUE



http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html

必需描述姓名

否警报名称的前缀。

类型：参数

有效值：现有警报名称的前缀。

默认：无

--alarm-name-prefix VALUE

否警报的状态。

类型：枚举

有效值：“正常”、“警报”或“数据不足”。

默认：所有警报状态。

--state-value VALUE



类型：字符串





类型：字符串





类型：整数


默认值：30




描述名称


类型：字符串



--delimiter VALUE


类型：标志



--headers


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE



描述名称


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE


• 警报 - 警报名称。



• DESCRIPTION - 警报描述。该列仅在 --show-long 视图中显示。• STATE - 警报状态。• STATE_REASON - 状态的人类可读原因。该列仅在 --show-long 视图中显示。• STATE_REASON_DATA - 状态的机器可读原因（JSON 格式）。该列仅在 --show-long 视图中显示。• ENABLED - 操作是否已启用。该列仅在 --show-long 视图中显示。• OK_ACTIONS - 状态为 OK 时要执行的操作。该列仅在 --show-long 视图中显示。• ALARM_ACTIONS - 状态为 ALARM 时要执行的操作。• INSUFFICIENT_DATA_ACTIONS - 状态为 INSUFFICIENT_DATA 时要执行的操作。该列仅在--show-long 视图中显示。

• NAMESPACE - 指标的命名空间。• METRIC_NAME - 指标名称。• DIMENSIONS - 维度。该列仅在 --show-long 视图中显示。• PERIOD - 周期。• STATISTIC - 统计数据。• UNIT - 单位。该列仅在 --show-long 视图中显示。• EVAL_PERIODS - 评估指标所需的周期数。• COMPARISON - 比较运算符。• THRESHOLD - 阈值。


示例示例请求此示例描述其名称以 my-alarm 开头的所有警报。

PROMPT> mon-describe-alarms --alarm-name-prefix my-alarm --headersThis is an example output of this command.

ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLDmy-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5

GreaterThanThreshold 80o.0


相关操作• DescribeAlarms


Amazon CloudWatch 开发人员指南示例

http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarms.html

相关评论• mon-describe-alarm-history (p. 110)• mon-describe-alarms-for-metric (p. 120)

mon-describe-alarms-for-metric描述提供有关与指定指标关联的警报的信息。

语法mon-describe-alarms-for-metric --metric-name value --namespace value[--dimensions "key1=value1,key2=value2..."] [--period value] [--statistic value][--unit value] [Common Options]


否指定与指标关联的维度。可以两种方式指定维度，其格式可结合使用或互换使用：

• 每个维度一个选项，例如 --dimension"key1=value1" --dimensions "key2=value2"

• 所有维度都在一个选项中，例如--dimension"key1=value1,key2=value2"

类型：映射

有效值：格式为 key=value 的字符串，其中，key是维度的名称，value是维度的值。维度名称和值必须是长度介于1到 250个字符之间的ANSI 字符串。最多允许 10 个维度。

默认：无

--dimensions -"key1=value1,key2=value2...

是指定要搜索其关联警报的指标的名称。

类型：参数

有效值：有效指标名称的长度介于1到 255个字符之间。

默认：无

--metric-name VALUE


Amazon CloudWatch 开发人员指南mon-describe-alarms-for-metric

必需描述姓名

是指定与要搜索的警报关联的指标的命名空间。有关命名空间的更多信息，请参阅 AWS 命名空间 (p. 79)。

类型：字符串

有效值：有效命名空间的长度介于1到 250个字符之间。

默认：无

--namespace VALUE

否指定按哪个周期筛选警报。结果中仅包含评估此周期的指标的警报。如果未指定，则会包含所有周期的警报。

类型：参数

有效值：以秒为单位的数字，是60秒的倍数。

默认：无

--period VALUE

否指定按其筛选警报的统计数据。仅包含指定统计数据的警报。如果未指定，则会包含所有统计数据的警报。

类型：枚举

有效值：SampleCount、Average、Sum、Minimum 或 Maximum

默认：无

--statistic VALUE


Amazon CloudWatch 开发人员指南选项

必需描述姓名

否指定按其筛选警报的单位。仅包含指定统计数据的警报。如果未指定，则会包含所有单位的警报。如果没有为警报指定单位，则搜索警报的唯一方式是忽略此选项。

类型：枚举

有效值：下列情况之一：

• 秒• 微秒• 毫秒• 字节数• 千字节• 兆字节• 千兆字节• 千吉字节• Bits• 千位• 兆位• 千兆位• 太位• 百分比• 数量• Bytes/Second• 千字节/秒• 兆字节/秒• 千兆字节/秒• 千吉字节/秒• Bits/Second• 千位/秒• 兆位/秒• 千兆位/秒• 太位/秒• Count/Second• 无

默认：无

--unit VALUE





类型：字符串





类型：字符串





类型：整数


默认值：30



类型：字符串



--delimiter VALUE


类型：标志



--headers



描述名称


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields



描述名称


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE


• 警报 - 警报名称。• DESCRIPTION - 警报描述。该列仅在 --show-long 视图中显示。• STATE - 警报状态。• STATE_REASON - 状态的人类可读原因。该列仅在 --show-long 视图中显示。• STATE_REASON_DATA - 状态的机器可读原因（JSON 格式）。该列仅在 --show-long 视图中显示。• ENABLED - 操作是否已启用。该列仅在 --show-long 视图中显示。• OK_ACTIONS - 状态为 OK 时要执行的操作。该列仅在 --show-long 视图中显示。• ALARM_ACTIONS - 状态为 ALARM 时要执行的操作。• INSUFFICIENT_DATA_ACTIONS - 状态为 INSUFFICIENT_DATA 时要执行的操作。该列仅在--show-long 视图中显示。

• NAMESPACE - 指标的命名空间。• METRIC_NAME - 指标名称。• DIMENSIONS - 维度。该列仅在 --show-long 视图中显示。• PERIOD - 周期。



• STATISTIC - 统计数据。• UNIT - 单位。该列仅在 --show-long 视图中显示。• EVAL_PERIODS - 评估指标所需的周期数。• COMPARISON - 比较运算符。• THRESHOLD - 阈值。


示例示例请求此示例描述给定指标的警报。

PROMPT> mon-describe-alarms-for-metric--metric-name CPUUtilization --namespace AWS/EC2 --dimensions InstanceId=i-abcdef

This is an example output of this command.

ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EV AL_PERIODS COMPARISON THRESHOLDmy-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80.0


相关操作• DescribeAlarmForMetric

相关评论• mon-describe-alarm-history (p. 110)• mon-describe-alarms (p. 115)

mon-disable-alarm-actions描述禁用指定警报的所有操作。



http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmsForMetric.html

语法mon-disable-alarm-actions [AlarmNames [AlarmNames ...]] [Common Options]


是指定要禁用其操作的警报名称的列表。还可以使用 --alarm-name设置此值。

类型：参数

有效值：警报名称的有效列表。

默认：无




类型：字符串





类型：字符串





类型：整数


默认值：30



Amazon CloudWatch 开发人员指南语法

描述名称


类型：字符串



--delimiter VALUE


类型：标志



--headers


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE



描述名称


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE

输出此命令禁用指定警报的警报操作。




示例示例请求此示例禁用名为 my-alarm 的警报的所有操作。

PROMPT> mon-disable-alarm-actions --alarm-name my-alarm


相关操作• DisableAlarmActions

相关评论• mon-enable-alarm-actions (p. 130)• mon-delete-alarms (p. 106)

mon-enable-alarm-actions描述启用指定警报的所有操作。

语法mon-enable-alarm-actions [AlarmNames [AlarmNames ...]] [Common Options]


是指定警报名称的列表。还可以使用--alarm-name设置此值。

类型：参数

有效值：警报名称的有效列表。

默认：无




http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DisableAlarmActions.html



类型：字符串





类型：字符串





类型：整数


默认值：30



类型：字符串



--delimiter VALUE


类型：标志



--headers



描述名称


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields



描述名称


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE

输出此命令启用指定警报的警报操作。


示例示例请求此示例启用名为 my-alarm 的警报的所有操作。

PROMPT> mon-enable-alarm-actions --alarm-name my-alarm




相关操作• EnableAlarmActions

相关评论• mon-disable-alarm-actions (p. 126)• mon-delete-alarms (p. 106)

mon-get-stats描述获取给定 MetricName 的一个或多个统计数据的时间序列数据。

Note

使用 mon-put-data命令创建新的指标时，可能需要两分钟时间，才能使用 mon-get-stats命令在新的指标上检索统计数据。但是，可能需要最多 15 分钟时间，新的指标才会出现在使用mon-list-metrics命令检索的指标列表中。

语法mon-get-stats MetricName --namespace value --statisticsvalue[,value...][--dimensions "key1=value1,key2=value2..."] [--end-time value][--period value] [--start-time value] [--unit value] [Common Options]


是指标要检索其统计数据的指标名称。还可以使用--metric-name设置此值。

类型：参数

有效值：介于 1 到 255 个字符之间的任何有效指标名称。

默认：无

MetricName



http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_EnableAlarmActions.html

必需描述姓名

否指定要检索的指标的维度。可以两种方式指定维度，其格式可结合使用或互换使用：


• 所有维度都在一个选项中，例如 --dimension"key1=value1,key2=value2"

类型：映射

有效值：格式为 key=value 的字符串，其中，key 是维度的名称，value 是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的ANSI 字符串。最多允许 10 个维度。

默认：无

--dimensions"key1=value1,key2=value2..."

否为返回的数据点指定允许的最新时间戳。不包括结束时间。时间戳是使用 ISO8601 组合格式指定的。例如日期和时间 2013 年 7 月 30 日12:30:00 将表示为：2013-07-30T12:30:00-07:00（太平洋标准时间），或 2013-07-30T19:30:00Z（协调世界时）。Amazon CloudWatch可返回的最高分辨率是 1 分钟，同样，所有时间戳向下舍入为最近的分钟。

类型：参数

有效值：采用ISO8601格式表示的有效时间戳，带有时区偏移或 UTC 指示符

默认：当前日期/时间。

--end-time VALUE

必需指定要检索其统计数据的指标的命名空间。有关命名空间的更多信息，请参阅 AWS 命名空间 (p. 79)。

类型：字符串

有效值：有效命名空间的长度介于 1 到 250 个字符之间。

默认：无

-n, --namespace VALUE

否指定要检索其统计数据的粒度（以秒为单位）。周期必须为至少为60秒，且必须为60的倍数。

类型：参数


默认：60 秒。

--period VALUE



必需描述姓名

是指定要为给定指标返回的统计数据。

类型：枚举

有效值：平均值、总和、最大值或最小值

默认：无

-s, --statisticsVALUE1,VALUE2,VALUE3...

否返回的数据点的第一个允许时间戳。包含开始时间。时间戳是使用 ISO8601 组合格式指定的。例如日期和时间2013年 7月 30日 12:30:00将表示为：2013-07-30T12:30:00-07:00（太平洋标准时间），或 2013-07-30T19:30:00Z（协调世界时）。Amazon CloudWatch可返回的最高分辨率是 1 分钟，同样，所有时间戳向下舍入为最近的分钟。

类型：参数

有效值：采用ISO8601格式表示的有效时间戳，带有时区偏移或 UTC 指示符

默认：当前时间之前的一个小时。

--start-time VALUE



必需描述姓名

否指定要检索其指标的单位。可以在多个单位中报告指标，因此检索特定单位的给定指标。不请求单位的结果将是返回所有单位。如果仅对一个单位报告指标，则无影响。

类型：枚举



默认：无

--unit VALUE





类型：字符串





类型：字符串





类型：整数


默认值：30



类型：字符串



--delimiter VALUE


类型：标志



--headers



描述名称


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields



描述名称


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE


• 时间 - 选取指标的时间。• SampleCount - 此列没有可用的描述。• Average - 平均值。• Sum - 值的总和。• Minimum - 观察到的最小值。• Maximum - 观察到的最大值。• 单位 – 指标的单位。




示例示例请求此示例返回 EC2 实例 i-c07704a9 在 1 小时分辨率时的平均、最小和最大 CPU 利用率。

PROMPT> mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minim um,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"

This is an example of an output of the Samples and Average metrics at one minute resolution.

Time Samples Average Unit 2013-05-19 00:03:00 2.0 0.19 Percent2013-05-19 00:04:00 2.0 0 Percent2013-05-19 00:05:00 2.0 0 Percent2013-05-19 00:06:00 2.0 0 Percent2013-05-19 00:07:00 2.0 0 Percent2013-05-19 00:08:00 2.0 0 Percent2013-05-19 00:09:00 2.0 0 Percent2013-05-19 00:10:00 2.0 0 Percent2013-05-19 00:11:00 2.0 0 Percent2013-05-19 00:12:00 2.0 0.195 Percent2013-05-19 00:13:00 2.0 0.215 Percent...

示例请求此示例返回您的 EC2 队列中的 CPU 利用率。

PROMPT> mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minim um,Maximum" --namespace "AWS/EC2"

示例请求此示例返回特定用户在 1 小时分辨率时对 MyService 的测试堆栈进行的平均、最小和最大请求计数。

PROMPT> mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minim um,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"

示例请求此示例显示所有“MyService”中的 RequestCount 统计数据。

PROMPT> mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Max imum,SampleCount" --namespace "MyService"




相关操作• GetMetricStatistics

相关评论• mon-list-metrics (p. 142)• mon-describe-alarms (p. 115)

mon-list-metrics描述列出与您的AWS账户关联的指标的名称、命名空间和维度。AmazonCloudWatch仅保留指标两个星期，因此超过两个星期的所有指标名称、命名空间和维度都不包含在列表中。可以使用指标名称、命名空间或维度的任意组合筛选指标。如果不指定筛选条件，则会返回针对该属性的所有可能的匹配项目。

Note

mon-list-metrics 命令可能最多需要 15 分钟的时间才能报告由对 mon-put-data的调用添加的新指标名称、命名空间和维度。mon-put-data放置的数据点或任何其他方法将在不到5分钟的时间内可供 mon-get-statistics使用。

语法mon-list-metrics [--dimensions "key1=value1,key2=value2..."] [--metric-namevalue] [--namespace value] [Common Options]





否指定要检索的指标的维度。可以两种方式指定维度，其格式可结合使用或互换使用：



如果未指定任何维度，将无法执行维度筛选。将仍应用所有其他请求的筛选条件。要包含在结果中，指标必须包含所有指定的维度，尽管该指标可能包含请求的指标之外的其他维度。

类型：映射


默认：无

-d, --dimensions"key1=value1,key2=value2..."

否指定要列出的特定指标的名称。要包含在结果中，该指标名称必须与请求的指标名称完全匹配。如果未指定指标名称，则不会执行筛选。将仍应用所有其他请求的筛选条件

类型：简便

有效值：长度介于1到 250个字符之间的所有有效指标名称。

默认：无

-m, --metric-name VALUE

否指定要用于筛选指标的命名空间。有关命名空间的更多信息，请参阅AWS命名空间(p.79)。

类型：字符串

有效值：有效命名空间的长度介于1到 250个字符之间。

默认：无

-n, --namespace VALUE





类型：字符串





类型：字符串





类型：整数


默认值：30



类型：字符串



--delimiter VALUE


类型：标志



--headers



描述名称


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields



描述名称


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE


• 指标名称 - 与该指标连接的指标的名称。• 命名空间 - 与该指标关联的命名空间。• 维度 - 与该指标关联的维度名称和值的列表。


示例示例请求此示例返回所有指标的列表。

PROMPT> mon-list-metricsThis is an example of an output of a call to 'mon-list-metrics'.



Metric Name Namespace DimensionsCPUUtilization AWS/EC2 {InstanceId=i-e7e48a8e}CPUUtilization AWS/EC2 {InstanceId=i-231d744a}CPUUtilization AWS/EC2 {InstanceId=i-22016e4b}CPUUtilization AWS/EC2 {InstanceId=i-b0345cd9}CPUUtilization AWS/EC2 {InstanceId=i-539dff3a}CPUUtilization AWS/EC2 {InstanceId=i-af3544c6}CPUUtilization AWS/EC2 {InstanceId=i-d4f29ebd}CPUUtilization AWS/EC2 {ImageId=ami-de4daab7}...

示例请求此示例返回具有特定指标名称的所有指标的列表。

PROMPT> mon-list-metrics --metric-name RequestCount

示例请求此示例返回属于特定命名空间的所有指标的列表。

PROMPT> mon-list-metrics --namespace MyService

示例请求此示例返回具有指定维度和值的所有指标的列表。

PROMPT> mon-list-metrics --dimensions "User=SomeUser,Stack=Test"


相关操作• ListMetrics

相关命令• mon-describe-alarms (p. 115)




mon-put-data描述向指标添加指标数据点。此调用将放置给定指标名称的原始值或有效统计数据值的时间序列数据。它支持一次输入一个数据点。

Note

使用 mon-put-data命令创建新的指标时，可能需要两分钟时间，才能使用 mon-get-stats命令在新的指标上检索统计数据。但是，可能需要最多 15 分钟时间，新的指标才会出现在使用mon-list-metrics命令检索的指标列表中。

语法mon-put-data --metric-name value[--namespace value [--dimensions"key1=value1,key2=value2..."] [--statisticValues "key1=value1,key2=value2..."][--timestamp value] [--unit value] [--value value] [Common Options]


否指定唯一标识指标数据的维度。可以两种方式指定维度，其格式可结合使用或互换使用：



类型：映射


默认：无

-d, --dimensions"key1=value1,key2=value2..."

是指定要存储其给定数据的指标的名称。

类型：字符串

有效值：介于1到 250个字符之间的任何有效指标名称。

默认：无

-m, --metric-nameVALUE1,VALUE2,VALUE3...


Amazon CloudWatch 开发人员指南mon-put-data

必需描述姓名

是指定包含指标的命名空间。有关命名空间的更多信息，请参阅 AWS 命名空间 (p. 79)。

类型：字符串

有效值：长度介于1到 255个字符之间的任何ANSI 字符串。

默认：无

n, --namespace VALUE

是指定要为给定时间戳和指标存储的统计数据。此选项是 --value专用的。至少必须指定--statisticValue或 --value之一。

类型：映射

有效值：包含所有统计数据名称的以下所有双精度值的字符串：SampleCount、Sum、Maximum 和 Minimum。所有这些值都必须是介于 1E-130 和 1E130 之间的值。

默认：无

-s, --statistic Values"key1=value1,key2=value2..."

否指定数据点的时间戳或要记录的指标的观察。时间戳是使用ISO8601组合格式指定的。例如日期和时间 2013 年 7 月 30 日 12:30:00 将表示为：2013-07-30T12:30:00-07:00（太平洋标准时间），或2013-07-30T19:30:00Z（协调世界时）。

类型：简便

有效值：采用 ISO8601 格式表示的有效时间戳，带有时区偏移或 UTC 指示符

默认：当前 UTC 时间。

-t, --timestamp VALUE



必需描述姓名

否指定记录观察所采用的单位。

类型：枚举



默认：无

-u, --unit VALUE

是指定将记录的单个值。该值将转换为以下形式的统计数据集：SampleCount=1,Sum=VALUE,Minimum=VALUE, Maximum=VALUE。此选项是 --statisticValues的专有选项。

类型：简便

有效值：所有值必须是介于 1E-130 和 1E130之间的数字。

默认：无

-v, --value VALUE





类型：字符串





类型：字符串





类型：整数


默认值：30



类型：字符串



--delimiter VALUE


类型：标志



--headers



描述名称


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields



描述名称


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE

输出此命令向指标添加指标数据点。


示例示例请求此示例将 RequestCount的统计数据放在 MyService命名空间中。该指标不包含维度，因此代表整个服务的总 RequestCount。测量值是预整合的 statisticValue，表示五个较早的测量值，其最大值是 70，最小值为 30，总和为 250。

PROMPT> mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maxim um=70,SampleCount=5"



示例请求此示例将用户特定的 RequestCount测试数据放在 MyService命名空间中。用户和堆栈名称存储为维度，以便将该指标与上面的示例中的服务范围的指标区分开。

PROMPT> mon-put-data --metric-name RequestCount --namespace "MyService" --dimen sions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50


相关操作• PutMetricData

相关命令• mon-put-metric-alarm (p. 154)

mon-put-metric-alarm描述创建或更新警报并将它与指定的AmazonCloudWatch指标关联。还可以使用此命令将一个或多个AmazonSimple Notification Service (Amazon SNS) 资源与警报关联。

此操作创建警报时，警报状态立即设置为INSUFFICIENT_DATA。将评估警报，并适当设置其StateValue。然后执行与 StateValue 关联的所有操作。

Note

更新现有警报时，其 StateValue 将保持不变。

语法mon-put-metric-alarm AlarmName --comparison-operator value --evaluation-periodsvalue --metric-name value --namespace value --period value --statistic value--threshold value [--actions-enabled value] [--alarm-actions value[,value...]][--alarm-description value] [--dimensions "key1=value1,key2=value2..."][--ok-actions value[,value...]] [--unit value] [--insufficient-data-actionsvalue[,value...]] [Common Options]





是指定要更新或创建的警报的名称。该名称在AWS 账户内必须是唯一的。还可以使用--alarm-name设置此值。

类型：参数

有效值：UTF-8 字符串。

默认：无

AlarmName

否指定在警报状态更改时是否应执行操作。

类型：布尔值

有效值：True 或 False

默认：True

--actions-enabled VALUE

否指定当此警报从除 ALARM 之外的任何其他状态转换为该状态时要执行的操作（最多 5 个）的列表。每个操作都被指定为一个亚马逊资源名称 (ARN)。目前，受支持的唯一操作是发布至Amazon Simple Notification Service主题或Auto Scaling 策略。

类型：字符串

有效值：Amazon SNS主题或Auto Scaling策略的 ARN。

默认：无

--alarm-actionsVALUE1,VALUE2,VALUE3...

否指定警报的描述。

类型：字符串

有效值：长度在 1 到 255 个字符之间的任何Unicode 字符串。

默认：无

--alarm-description VALUE

是指定将用于比较数据点与阈值的比较运算符。

类型：枚举

有效值：GreaterThanOrEqualToThreshold、GreaterThanThreshold、LessThanThreshold或 LessThanOrEqualToThreshold 之一

默认：无

--comparison-operatorVALUE



必需描述姓名

否指定要为其创建警报的指标的维度。可以两种方式指定维度，其格式可结合使用或互换使用：



类型：映射


默认：无

--dimensions"key1=value1,key2=value2..."

是指定指标的值将与阈值相比较以确定警报状态的连续周期数。

类型：整数

有效值：大于零的数。

默认：无

--evaluation-periodsVALUE

是指定要对其报警的指标的名称。

类型：参数


默认：无

--metric-name VALUE

是指定要对其报警的指标的命名空间。有关命名空间的更多信息，请参阅 AWS 命名空间 (p. 79)。

类型：字符串


默认：无

--namespace VALUE

否指定当此警报从除 OK 之外的任何其他状态转换为该状态时要执行的操作（最多 5 个）的列表。每个操作都被指定为一个亚马逊资源名称(ARN)。目前，受支持的唯一操作是发布至Amazon Simple Notification Service 主题或Auto Scaling 策略。

类型：字符串

有效值：有效的 ARN 标识符。

默认：无

--ok-actionsVALUE1,VALUE2,VALUE3...



必需描述姓名

是指定要对其报警的指标的时间段（以秒为单位）。

类型：参数


默认：无

--period VALUE

是指定要对其报警的指标的统计数据。

类型：枚举

有效值：SampleCount、Average、Sum、Minimum 或 Maximum

默认：无

--statistic VALUE

是指定数据点将与其进行比较以确定警报状态的阈值。

类型：双精度

有效值：双精度值。所有值必须是介于1E-130和 1E130 之间的数字。

默认：无

--threshold VALUE



必需描述姓名

否指定要对其报警的指标的单位。

类型：枚举



默认：无

--unit VALUE

否指定当此警报从除INSUFFICIENT_DATA之外的任何其他状态转换为该状态时要执行的操作（最多 5 个）的列表。每个操作都被指定为一个亚马逊资源名称 (ARN)。目前，受支持的唯一操作是发布至 Amazon Simple NotificationService 主题或 Auto Scaling 策略。

类型：字符串

有效值：有效的 ARN 标识符。

默认：无

--insufficient-data-actionsVALUE1,VALUE2,VALUE3...





类型：字符串





类型：字符串





类型：整数


默认值：30



类型：字符串



--delimiter VALUE


类型：标志



--headers



描述名称


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields



描述名称


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE

输出此命令创建或更新与指定指标关联的警报。


示例示例请求此示例创建一个警报my-alarm，当EC2实例的CPU利用率超过90%的时间达到三个连续的一分钟时，该警报会向主题发布消息。

PROMPT> mon-put-metric-alarm --alarm-name my-alarm --alarm-description "some desc" --metric-name CPUUtilization --namespace AWS/EC2 --stat istic Average --period 60 --threshold 90 --comparison-operator GreaterTh anThreshold --dimensions InstanceId=i-abcdef --evaluation-periods 3 --unit Percent --alarm-actions arn:aws:sns:us-east-1:1234567890:my-topic




相关操作• PutMetricAlarm

相关命令• mon-put-data (p. 148)

mon-set-alarm-state描述临时更改警报状态。在下一个时间段，警报设为 true 状态。

语法mon-set-alarm-state AlarmName --state-reason value --state-value value[--state-reason-data value] [Common Options]


是指定警报的名称。还可以使用--alarm-name设置此值。

类型：参数

有效值：UTF-8 字符串。

默认：无

AlarmName

是指定将此警报设置为此状态（人类可读）的原因。

类型：字符串

有效值：介于 1 到 1023 个字符之间的 UTF-8字符串。

默认：无

--state-reason VALUE



http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html

必需描述姓名

否指定将此警报设置为此状态的原因。此数据规定为机器可读 JSON。

类型：字符串

有效值：介于 1 到 4000 个字符之间的有效机器可读 JSON 字符串。

默认：无

--state-reason-data VALUE

是指定应将警报设置为哪种状态。

类型：枚举

有效值：ALARM、OK 或INSUFFICIENT_DATA

默认：无

--state-value VALUE



类型：字符串





类型：字符串





类型：整数


默认值：30




描述名称


类型：字符串



--delimiter VALUE


类型：标志



--headers


类型：字符串


默认值：无



类型：字符串


默认值：无



类型：字符串



--region VALUE



描述名称


类型：字符串


默认值：无



类型：标志

有效值：无


--show-empty-fields


类型：标志

有效值：无

默认值：false

--show-request


类型：标志

有效值：无




类型：字符串



-U, --url VALUE

输出当请求成功时，此命令暂时更改警报的状态并显示 OK-Set alarm state value。




示例示例请求此示例将名为 my-alarm 的警报的状态设置为 OK。

PROMPT> mon-set-alarm-state --alarm-name my-alarm --state OK


相关操作• SetAlarmState

相关命令• mon-describe-alarms (p. 115)

mon-version描述打印 CLI 和 API 的 Amazon CloudWatch 版本号。

语法mon-version

输出此命令显示 Amazon CloudWatch CLI 和 API 的版本。


示例示例请求此示例演示 CLI 和 API 版本。



http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_SetAlarmState.html

PROMPT> mon-version

Amazon CloudWatch CLI version 1.0.12.1 (API 2010-08-01)


相关命令• mon-cmd (p. 104)

CLI 示例此部分展示了一些 CLI 使用示例。

Note

此部分对Amazon CloudWatch和 Amazon EC2使用CLI。有关Amazon EC2 CLI 的详细信息，请转到 Amazon Elastic Compute Cloud 用户指南中的命令行工具入门部分。

• 如以下示例所示使用 EC2 ec2-run-instances命令。

PROMPT>ec2-run-instances ami-60a54009 -n 3 --availability-zone us-east-1a

Note

如果想要自动监控由上述命令启动的所有 EC2 实例，应添加 --monitoring。这可以跳过本流程中的第 2 步。

此命令会为每个启动的实例返回一个唯一的识别符。您可以使用实例 ID 操纵实例。这包括查看实例的状态、终止实例等操作。启动实例需要几分钟时间。

RESERVATION r-237fed4a 853279305796 defaultINSTANCE i-d9add0b0 ami-60a54009 pending 0 m1.small 2009-05-14T12:38:24+0000 us-east-1a aki-a71cf9ce ari-a51cf9cc monitoring-disabled

• 使用 mon-list-metrics命令获取为您的 AWS 账户储存的指标的列表。例如：

PROMPT>mon-list-metrics

mon-list-metrics会输出一张表格，其中包括与每个指标关联的指标名称、命名空间和维度。例如：



http://docs.aws.amazon.com/AWSEC2/2010-11-15/UserGuide/SettingUp_CommandLine.html

CPUUtilization AWS/EC2 {InstanceId=i-c385b3aa}CPUUtilization AWS/EC2 {ImageId=ami-11ca2d78}CPUUtilization AWS/EC2 {InstanceType=m1.small}CPUUtilization AWS/EC2DiskReadBytes AWS/EC2 {ImageId=ami-11ca2d78}DiskReadBytes AWS/EC2 {InstanceType=m1.small}DiskReadBytes AWS/EC2DiskReadBytes AWS/EC2 {InstanceId=i-c385b3aa}DiskReadOps AWS/EC2 {InstanceId=i-c385b3aa}DiskReadOps AWS/EC2 {InstanceType=m1.small}DiskReadOps AWS/EC2DiskReadOps AWS/EC2 {ImageId=ami-11ca2d78}DiskWriteBytes AWS/EC2 {InstanceId=i-c385b3aa}DiskWriteBytes AWS/EC2 {InstanceType=m1.small}DiskWriteBytes AWS/EC2 {ImageId=ami-11ca2d78}DiskWriteBytes AWS/EC2DiskWriteOps AWS/EC2 {InstanceId=i-c385b3aa}DiskWriteOps AWS/EC2 {ImageId=ami-11ca2d78}DiskWriteOps AWS/EC2 {InstanceType=m1.small}DiskWriteOps AWS/EC2NetworkIn AWS/EC2NetworkIn AWS/EC2 {InstanceId=i-c385b3aa}NetworkIn AWS/EC2 {ImageId=ami-11ca2d78}NetworkIn AWS/EC2 {InstanceType=m1.small}NetworkOut AWS/EC2 {InstanceType=m1.small}NetworkOut AWS/EC2NetworkOut AWS/EC2 {ImageId=ami-11ca2d78}NetworkOut AWS/EC2 {InstanceId=i-c385b3aa}

• 如以下示例所示使用 EC2 ec2-monitor-instances命令。

PROMPT> ec2-monitor-instances i-43a4412a

ec2-monitor-instances会返回一张表格，其中包含了选定的实例 ID 和当前的监控状态。

i-43a4412a monitoring-pending

• 如以下示例所示使用 Amazon CloudWatch mon-get-stats命令。

PROMPT> mon-get-stats CPUUtilization --start-time 2013-05-15T00:00:00 --end-time 2013-05-16T00:00:00 --period 60 --statistics "Average" --namespace "AWS/EC2" --dimensions "ImageId=ami-60a54009"

Amazon CloudWatch 会返回一条与下面类似的响应（为了简洁起见，只截取了一部分数据）：

2013-05-15 22:42:00 0.38 Percent2013-05-15 22:48:00 0.39 Percent2013-05-15 22:54:00 0.38 Percent


Amazon CloudWatch 开发人员指南CLI 示例

Note

Amazon CloudWatch 按以下顺序返回此函数的数据：日期、时间、示例、CPU 利用率和单位。


Amazon CloudWatch 开发人员指南CLI 示例

创建 API 请求

与 Amazon CloudWatch 一起使用的查询请求为 HTTP 或 HTTPS 请求，它们使用 HTTP 动词 GET 或POST，以及名为Action或Operation的查询参数。此文件自始至终使用的都是“Action”，尽管“Operation”支持与其他 AWS 查询 API 反向兼容。

Topics• Amazon CloudWatch 终端节点 (p. 170)• 查询参数 (p. 170)• 请求 ID (p. 171)• Query API 身份验证 (p. 171)• 使用签名版本 2 的查询 API 示例 (p. 172)• 使用签名版本 2 的查询 API 错误消息 (p. 175)• 可用的库 (p. 176)

Amazon CloudWatch 终端节点有关使用 Amazon CloudWatch 的地区和终端节点的信息，请参阅 Amazon Web Services 一般参考中的地区和终端节点。

查询参数每个查询请求必须包含一些常用参数，以处理身份验证和操作选择。有关更多信息，请参阅 AmazonCloudWatch API 参考中的常见查询参数。

Note

有些API 操作采用参数列表。这些列表都是使用以下表示法指定的：param.member.n. n 的值是从1开始的整数。所有参数列表都必须遵循此表示法，包括仅有一个参数的列表。例如，查询参数列表应如下所示：

&attribute.member.1=this&attribute.member.2=that


Amazon CloudWatch 开发人员指南Amazon CloudWatch 终端节点


http://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/CommonParameters.html

请求 ID在每个来自 Amazon Web Services (AWS) 的响应中，您都会发现包含一个名为 RequestId的字符串元素的 ResponseMetadata。这只是 AWS 分配用于提供追踪信息的唯一识别符。尽管 RequestId包括在每个响应中，但为了改进 API 文档的可读性和减少冗余，不会将其列在单独的 API 文档页面中。

Query API 身份验证您可以通过HTTP或HTTPS发送查询请求。不论您使用的是何种协议，都必须在每个查询请求中包含签名。本部分描述了如何创建签名。以下过程中描述的方法称为签名版本2。有关创建和包括签名的更多信息，请参阅 AWS General Reference中的签署 AWS API 请求。

创建签名

1. 创建标准化的查询字符串，您在此过程的稍后部分需要用到它：

a. 根据参数名称、按照自然字节排序对 UTF-8 查询字符串组成部分进行分类。参数可取自 GET URI 或 POST 正文（当 Content-Type为application/x-www-form-urlencoded时）。

b. URL 根据以下规则对参数名称和值进行编码：

• 不对任何由 RFC 3986 定义的非预留字符进行 URL 编码。这些非预留字符是指 A-Z、a-z、0-9、连字符 (-)、下划线 ( _ )、句点 (.) 和波浪符 ( ~ )。

• 使用 %XY 对所有其他参数进行百分比编码，其中“X”和“Y”分别代表十六进制字符 0-9 和大写字母 A-F。

• 以 %XY%ZA.... 格式对扩展的 UTF-8 字符进行百分号编码。• 将空白字符百分号编码为%20（不是普通编码方案中的 +）。

Note

目前所有的 AWS 服务参数名称均使用非预留字符，因此您无需对其进行编码。但是，您可能希望添加代码以处理使用预留字符的参数名称，以供未来使用。

c. 使用等号 ( = )（ASCII 字符 61）将编码的参数名称与它们的编码值分隔开，即使参数值为空，亦应如此。

d. 使用“&”号（ASCII 代码 38）隔开名称-值对。

2. 依照下列伪语法创建一个要签名的字符串（"\n"代表 ASCII 换行符）。

StringToSign = HTTPVerb + "\n" + ValueOfHostHeaderInLowercase + "\n" + HTTPRequestURI + "\n" + CanonicalizedQueryString <from the preceding step>

HTTPRequestURI组件是URI的HTTP绝对路径组件，但不包括查询字符串。如果HTTPRequestURI为空，则使用正斜杠 ( / )。

3. 利用您刚创建的字符串计算符合RFC2104的HMAC，将您的私有访问密钥当作密钥，并将SHA256或 SHA1 作为散列算法。有关更多信息，请参阅 http://www.ietf.org/rfc/rfc2104.txt。


Amazon CloudWatch 开发人员指南请求 ID

http://docs.aws.amazon.com/general/latest/APIReference/gr/signing_aws_api_requests.html

4. 将结果值转换为 base64。5. 使用结果值作为 Signature请求参数的值。

Important

您在请求中发送的最终签名必须按照 RFC 3986 的规定进行 URL 编码（有关更多信息，请访问http://www.ietf.org/rfc/rfc3986.txt）。如果您的工具包对您的最终请求进行 URL 编码，它也会处理签名所需的URL编码。如果您的工具包未对您的最终请求进行URL编码，确保在您将签名添加到请求中之前，对签名进行URL编码。最重要的是，确保签名只经过一次URL编码。一个常见错误是在签名形成过程中手动对其进行 URL 编码，并且工具包随后对整个请求进行 URL 编码。

使用签名版本 2 的查询 API 示例Example ListMetrics API 请求

此示例使用 Amazon CloudWatch ListMetrics 操作。

http://monitoring.amazonaws.com/?SignatureVersion=2&Action=ListMetrics&Version=2010-08-01&AWSAccessKeyId=<Your AWS Access Key Id>&SignatureVersion=2&SignatureMethod=HmacSHA256&Timestamp=2010-11-17T05%3A13%3A00.000Z

下方是待签字符串。

GET\nmonitoring.amazonaws.com\n/\nAWSAccessKeyId=<Your AWS Access Key Id>&Action=ListMetrics&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2010-11-17T05%3A13%3A00.000Z&Version=2010-08-01

下方是已签名请求。

http://monitoring.amazonaws.com/?Action=ListMetrics&SignatureVersion=2&SignatureMethod=HmacSHA256&Timestamp=2010-11-17T05%3A13%3A00.000Z&Signature=<URLEncode(Base64Encode(Signature))>&Version=2010-08-01&AWSAccessKeyId=<Your AWS Access Key Id>


Amazon CloudWatch 开发人员指南使用签名版本 2 的查询 API 示例


Example ListMetrics API 请求使用 NextToken 值

此示例使用 Amazon CloudWatch ListMetrics 操作和 NextToken 值来检索 500 多个指标。

1. 根据以下伪语法（"\n"代表 ASCII 换行符）创建待签字符串。

StringToSign = HTTPVerb + "\n" +ValueOfHostHeaderInLowercase + "\n" +HTTPRequestURI + "\n" + CanonicalizedQueryString <from the preceding step>

HTTPRequestURI组件是 URI（取决于但不包括查询字符串）的 HTTP 绝对路径组件。如果HTTPRequestURI为空，请使用正斜杠 ( / )。

2. 如下方示例所示准备一个待签字符串：

GET\nmonitoring.amazonaws.com\n/\nAWSAccessKeyId=<Your AWS Access Key Id>&Action=ListMetrics&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2010-11-17T05%3A13%3A00.000Z&Version=2010-08-01

下方内容在此示例中指定：

Action指定了要进行的操作（例如 ListMetrics）。

AWSAccessKeyId指定了您的 AWS 账户的 AccessKeyId（将 <您的 AWS 访问密钥 ID> 替换为您的实际 AWSAccessKeyId）。

SignatureVersion指定了签名的版本（例如 2）。

Timestamp2012-09-27T17:06:23.000Z指定了请求的时间戳（例如 09/27/2012, 17:06:23）。

Version2010-08-01指定了 ListMetrics API 的版本（例如：最后发布于 2010-08-01）。3. 以上一步中的字符串签署请求 URL。下方是已签名请求 URL 的示例。

http://monitoring.amazonaws.com?SignatureVersion=2&Action=ListMetrics&Version=2010-08-01&Timestamp=2012-09-27T17%3A14%3A01.000Z&AWSAccessKeyId=<Your AWS Access Key ID>&Signature=iE68300Pbl%2BDsKM5mFiOhHWEXAMPLE

下方内容在此示例中指定：

Action指定了要进行的操作（例如 ListMetrics）。

Version=2010-08-01指定了 ListMetrics API 的版本（例如：最后发布于 2010-08-01）。

Timestamp=2012-09-27T17:06:23.000Z指定了请求的时间戳（例如09/27/2012, 17:06:23）。

AWSAccessKeyId指定了您的 AWS 账户的 AccessKeyId（将 <您的 AWS 访问密钥 ID> 替换为您的实际 AWSAccessKeyId）。




Signature指定了用于签署请求的签名（例如<URLEncode(Base64Encode(Signature))>=iE68300Pbl%2BDsKM5mFiOhHWEXAMPLE）。

4. 复制已签名的请求URL到您的Web浏览器并按“Enter”键以运行请求。应该得到与下方类似的结果：

<ListMetricsResponse> <ListMetricsResult> <Metrics> <member> <Dimensions> <member> <Name>InstanceId</Name> <Value>i-8dea01f0</Value> </member> </Dimensions> <MetricName>CPUUtilization</MetricName> <Namespace>AWS/EC2<Namespace> </member> <member> <Dimensions> <member> <Name>InstanceId</Name> <Value>i-7dee09t3</Value> </member> </Dimensions> <MetricName>CPUUtilization</MetricName> <Namespace>AWS/EC2<Namespace> <member> </member> </Metrics> <NextToken>NNNTTT</NextToken> </ListMetricsResult> <ResponseMetadata> <RequestId>8f95da07-08c8-11e2-9cdd-4d93ea583888</RequestId> </ResponseMetadata></ListMetricsResponse>

5. 在步骤 4的输出中，保存 NextToken值。在此示例中为 NNNTTT，但是一般情况下它是一个非常长的字符串。

6. 准备待签名的字符串并包含 NextToken=NNNTTT值。7. 使用步骤 6 中的字符串签署请求 URL。以下示例是已签名请求 URL。它与步骤 3 中的已签名请求

URL 类似，不同之处是此处包含 NextTokenNNNTTT值。

http://monitoring.amazonaws.com?SignatureVersion=2&Action=ListMetrics&Version=2010-08-01&NextToken=NNNTTT&Timestamp=2012-09-27T17%3A45%3A14.000Z&AWSAccessKeyId=<Your AWS Access Key ID>&Signature=iE68300Pbl%2BDsKM5mFiOhHWEXAMPLE

8. 要得到下一批 500 个指标，复制已签名的请求 URL 到您的Web 浏览器并按“Enter”键。可以用相同的参数和新的 NextToken重复请求，直到完成对所有指标的检索。



使用签名版本 2 的查询 API 错误消息Example 使用错误的 AWS 私有访问密钥计算签名时的错误消息

<ErrorResponse> <Error> <Type>Sender</Type> <Code>SignatureDoesNotMatch</Code> <Message> The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. Consult the service documentation for details. </Message> </Error> <RequestId>a9c1a06e-0d80-11e2-ac80-9646d110ca61<RequestId></ErrorResponse>

Example 使用错误的 AWS AccessKeyID 时的错误消息

<ErrorResponse> <Error> <Type>Sender</Type> <Code>InvalidClientTokenId</Code> <Message> The security token included in the request is invalid </Message> </Error> <RequestId>5134a3b8-0d82-11e2-9b0a-db3eb46b3dbd</RequestId></ErrorResponse>


Amazon CloudWatch 开发人员指南使用签名版本 2 的查询 API 错误消息

Example 提供不正确参数时的错误消息

以下示例演示如何使用 MetricName参数“TestMetric”发出请求。

已签名 URL 外观类似于：

http://monitoring.amazonaws.com?SignatureVersion=2&Action=ListMetrics&Version=2010-08-01&MetricName=TestMetric&Timestamp=2012-09-27T17%3A14%3A01.000Z&AWSAccessKeyId=<Your AWS Access Key ID>&Signature=iE68300Pbl%2BDsKM5mFiOhHWEXAMPLE

当您想通过 NextToken 检索更多指标时，必须提供与前一请求相同的参数。如果提供了错误的参数、较多的参数或较少的参数（假定 NextToken 正确），则将会得到以下错误：

<ErrorResponse> <Error> <Type>Sender</Type> <Code>InvalidParameterValue</Code> <Message>Invalid nextToken</Message> </Error> <RequestId>cb1c4191-0e5d-11e2-9c15-6f306828daaa<RequestId></ErrorResponse>

可用的库对于那些喜欢使用语言特定的API 而不是命令行工具和查询API 构建应用程序的软件开发人员，AWS为他们提供了库、示例代码、教程和其他资源。这些库提供了一些基本功能（未包括在 API 中），比如请求身份验证、请求重试和错误处置，以便您轻松地开始工作。现已推出适用以下语言和平台的库和资源：

• Android• iOS• Java• PHP• Python• Ruby• Windows 和 .NET

有关所有语言的库和示例代码，请参阅示例代码和库。


Amazon CloudWatch 开发人员指南可用的库

http://aws.amazon.com/sdkforandroid

http://aws.amazon.com/sdkforios

http://aws.amazon.com/java

http://aws.amazon.com/php

http://aws.amazon.com/python

http://aws.amazon.com/ruby

http://aws.amazon.com/net

http://aws.amazon.com/code

文档历史记录

下表介绍对 Amazon CloudWatch 开发人员指南进行的一些重要修改。本文档与 2010-08-01 发布的Amazon CloudWatch 关联。本指南最后一次更新时间为 2013 年 10 月 29 日。

发行日期描述变更

2013 年 10 月 29 日更新主题，以涵盖全新的 Amazon CloudWatch 控制台。

更新指南以匹配新的 AmazonCloudWatch 控制台

2013 年 9 月 6 日重写和重构了该开发人员指南，以包括入门指南、入门部分、更新的命令行界面参考以及用于处理指标和警报的更新/其他过程。

重写 AmazonCloudWatch 开发人员指南

2013 年 2 月 22 日针对Linux监控脚本的额外更新增加了对AWS Identityand Access Management (IAM) 角色的支持，使用AutoScaling报告指标，还增加了对聚合CloudWatch指标的选项。有关更多信息，请参阅用于 Linux 的Amazon CloudWatch监控脚本 (p. 61)。

针对 Linux 的AmazonCloudWatch 监控脚本更新

2013 年 1 月 8 日增加了一个用于记录 Amazon CloudWatch 警报操作的部分，您可以使用这些操作停止或终止 AmazonElastic Compute Cloud实例。有关更多信息，请参阅创建停止或终止实例的警报 (p. 48)。

新功能：AmazonCloudWatch 警报操作

2012 年 11 月 20 日已将EBS指标更新至包含配置的 IOPS卷的两项新指标。有关更多信息，请参阅 Amazon EBS 维度与指标 (p. 87)。

更新的 EBS 指标

2012 年 7 月 19 日现在可以使用针对Windows 的 Amazon CloudWatch监控脚本生成和使用 Amazon CloudWatch 自定义指标。有关更多信息，请参阅用于Windows的AmazonCloudWatch 监控脚本 (p. 66)。

新脚本

2012 年 2 月 24 日现在可以使用针对 Linux 的 Amazon CloudWatch 监控脚本生成和使用AmazonCloudWatch自定义指标。有关更多信息，请参阅用于 Linux 的 AmazonCloudWatch监控脚本 (p. 61)。

新脚本




2011 年 10 月 19 日现在可以访问6种新的Elastic Load Balancing指标，它们提供多种HTTP响应代码的计数。有关更多信息，请参阅 Elastic Load Balancing 维度与指标 (p. 91)。

新指标

2011 年 6 月 30 日现在可以从 Amazon Elastic MapReduce 访问指标。有关更多信息，请参阅 the section called “AmazonElastic MapReduce 维度与指标” (p. 92)。

新功能

2011 年 7 月 14 日现在可以从 Amazon Simple Notification Service 和Amazon Simple Queue Service 访问指标。有关详细信息，请参阅the section called “Amazon SimpleNotification Service 维度与指标” (p. 98)和the sectioncalled “Amazon SQS 维度与指标” (p. 99)。

新功能

2011 年 7 月 1 日重命名、合并、移动章节，包括整个用户场景一节：

• 针对AWS产品的CloudWatch支持现在是AmazonCloudWatch 命名空间、维度和指标参考 (p. 79)

• 列出可用指标现在是the section called “查看可用指标” (p. 22)

• 获取指标的统计信息现在是the section called “获取指标的统计数据” (p. 25)

• 创建发送电子邮件的警报现在是创建 AmazonCloudWatch 警报 (p. 39)

新编指南

2011 年 6 月 7 日添加了一个介绍如何使用 AWS Identity and AccessManagement (IAM) 的部分。有关更多信息，请参阅控制用户访问您的 AWS 账户 (p. 75)。

新章节

2011 年 5 月 10 日添加了有关使用 PutMetricData API 发布自定义指标的信息。有关详细信息，请参阅the section called“发布自定义指标” (p. 37)或转到Amazon CloudWatchGetting Started Guide。

新功能

2011 年 4 月 07 日AmazonCloudWatch现在对警报历史记录的保留时间为 2 周，而不是 6 周。这一改变让警报的保留时间和指标数据的保留时间相一致。

更新的内容

2011 年 2 月 3 日此服务的终端节点的信息现在位于 Amazon WebServices General Reference 中。有关详细信息，请转到 Amazon Web Services 一般参考中的“地区和终端节点”。

新链接

2011 年 2 月 11 日添加了有关使用 AWS 管理控制台对 AmazonCloudWatch 进行管理的信息。

更新的内容

2011 年 1 月 19 日添加了有关警报和 Auto Scaling 的简要讨论。特别要指出的是，警报会在超出阈值期间（而不只是在阈值才刚超出之后）继续调用 Auto Scaling 策略通知。有关更多信息，请参阅警报 (p. 8)。

更新的内容



http://docs.aws.amazon.com/AmazonCloudWatch/latest/GettingStartedGuide/

http://docs.aws.amazon.com/AmazonCloudWatch/latest/GettingStartedGuide/



2011 年 1 月 18 日从 Elastic Load Balancing RequestCount 指标的有效统计数据列表中删除了 Minimum和 Maximum。RequestCount的唯一有效统计数据是Sum。有关所有Elastic Load Balancing 指标的列表，请参阅 ElasticLoad Balancing 维度与指标 (p. 91)。

更新的内容

2010 年 12 月 2 日添加了当指标越过阈值时发送 Amazon SimpleNotification Service 或 Auto Scaling 通知的功能。有关更多信息，请参阅警报 (p. 8)。

新功能

2010 年 12 月 2 日多种AmazonCloudWatch操作现在包括MaxRecords和 NextToken参数，让您可以控制要显示的结果页。

新功能



AmazonCloudWatchawsdocs.s3.amazonaws.com/AmazonCloudWatch/latest/acw-dev... · 2014-02-25 ·...

Documents

Transcript of AmazonCloudWatchawsdocs.s3.amazonaws.com/AmazonCloudWatch/latest/acw-dev... · 2014-02-25 ·...