mon-get-stats
描述
获取指定统计数据的时间序列数据。
注意
当您使用 mon-put-data 命令创建新的指标时，可能需要两分钟时间，之后方可使用 mon-get-stats 命令在新的指标上检索统计信息。但是，这可能需要最多 15 分钟时间，之后新的指标会出现在使用 mon-list-metrics 命令检索的指标列表中。
语法
mon-get-stats MetricName
--namespace
value --statistics value[,value...] [--dimensions "key1=value1,key2=value2..."
] [--end-time value] [--period value] [--start-time value] [--unit value] [Common Options]
Options
| 名称 | 描述 |
|---|---|
|
|
指标的名称。还可以使用 类型：参数 有效值：长度介于 1 到 255 个字符之间的任何有效指标名称。 默认值：不适用 必需：是 |
|
|
指标的维度。可以两种方式指定维度，且格式可结合使用或互换使用：
类型：映射 有效值：格式为 name=value 的字符串，其中，键是维度的名称，值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。 默认值：不适用 必需：否 |
|
|
返回的数据点的最新允许时间戳。不包括结束时间。时间戳是使用 ISO8601 组合格式指定的。例如，日期和时间 2013 年 7 月 30 日 12:30:00 将表示为：2013-07-30T12:30:00-07:00（太平洋标准时间），或 2013-07-30T19:30:00Z（协调世界时）。CloudWatch 可返回的最高分辨率是 1 分钟，同样，所有时间戳向下舍入为最近的分钟。 类型：参数 有效值：采用 ISO8601 格式表示的有效时间戳，带有时区偏移或 UTC 指示符。 默认值：当前日期/时间。 必需：否 |
|
|
指标的命名空间。有关命名空间的更多信息，请参阅 Amazon 命名空间。 类型：字符串 有效值：长度介于 1 到 250 个字符之间的有效命名空间。 默认值：不适用 必需：是 |
|
|
要检索其统计数据的粒度（以秒为单位）。周期必须为至少为 60 秒，且必须为 60 的倍数。 类型：参数 有效值：以秒为单位的数字，是 60 秒的倍数。 默认值：60 秒。 必需：否 |
|
|
要为给定指标返回的统计数据。 类型：枚举 有效值：Average、Sum、Maximum 或 Minimum 默认值：不适用 必需：是 |
|
|
返回的数据点的第一个允许时间戳。包含开始时间。时间戳是使用 ISO8601 组合格式指定的。例如，日期和时间 2013 年 7 月 30 日 12:30:00 将表示为：2013-07-30T12:30:00-07:00（太平洋标准时间），或 2013-07-30T19:30:00Z（协调世界时）。CloudWatch 可返回的最高分辨率是 1 分钟，同样，所有时间戳向下舍入为最近的分钟。 类型：参数 有效值：采用 ISO8601 格式表示的有效时间戳，带有时区偏移或 UTC 指示符。 默认值：当前时间之前的一个小时。 必需：否 |
|
|
要检索其指标的单位。可以用多个单位报告指标，这会检索特定单位的给定指标。不请求单位的结果将是返回所有单位。如果仅对一个单位报告指标，则无影响。 类型：枚举 有效值：下列值之一：
默认值：不适用 必需：否 |
常用选项
| 名称 | 描述 |
|---|---|
|
|
带有 Amazon 凭证的文件的位置。您可以使用环境变量 类型：字符串 有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。 默认值：使用环境变量 |
|
|
用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 类型：字符串 有效值：由 Amazon EC2 或 Amazon Identity and Access Management 提供的 PEM 文件的有效路径。 默认值：使用环境变量 |
|
|
连接超时值（以秒为单位）。 类型：整数 有效值：任何正数。 默认：30 |
|
|
显示经分隔（长）结果时使用的分隔符。 类型：字符串 有效值：任意字符串。 默认值：逗号 (,) |
|
|
如果要显示表格结果或分隔结果，请包括列标题。如果要显示 XML 结果，请从服务请求返回 HTTP 标头（如果适用）。 类型：标记 有效值：如果存在，则显示标头。 默认值：默认情况下， |
|
|
访问密钥 ID 将与私有密钥共同用于签署请求。其必须与私有密钥结合使用，否则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。 类型：字符串 有效值：有效访问密钥 ID。 默认值：无 |
|
|
将用于签署请求的私有密钥。使用公有/私有密钥会导致 CLI 使用 SOAP。此请求通过公有证书和私有密钥签署。此参数必须与 类型：字符串 有效值：有效 ASN.1 私有密钥的路径。 默认值：无 |
|
|
定向到区域请求。您可以使用环境变量 类型：字符串 有效值：任意 Amazon 区域，例如 us-east-1。 默认值：除非 |
|
|
将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 类型：字符串 有效值：您的访问密钥 ID。 默认值：无 |
|
|
使用 (nil) 作为占位符显示空字段，以指示未请求此数据。 类型：标记 有效值：无 默认值：默认情况下不显示空字段。 |
|
|
显示 CLI 用于调用 Amazon 的 URL。 类型：标记 有效值：无 默认：false |
|
|
指定结果的显示方式：表格、分隔（长）、XML 或无输出（无提示）。 类型：标记 有效值：无 默认： |
|
|
用于联系 CloudWatch 的 URL。您可以使用环境变量 类型：字符串 有效值：有效 HTTP 或 HTTPS URL。 默认值：使用 |
输出
此命令将返回包含以下内容的表格：
-
Time - 选取指标的时间。
-
SampleCount - 此列没有可用的描述。
-
Average - 平均值。
-
Sum - 值的总和。
-
Minimum - 观察到的最小值。
-
Maximum - 观察到的最大值。
-
单位 – 指标的单位。
Amazon CloudWatch CLI 在 stderr 上显示错误。
示例
示例请求
此示例返回 EC2 实例 i-c07704a9 在 1 小时分辨率时的平均、最小和最大 CPU 利用率。
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"
此示例展示了示例和平均指标在一分钟分辨率时的输出。
Time Samples Average Unit 2013-05-19 00:03:00 2.0 0.19 Percent 2013-05-19 00:04:00 2.0 0 Percent 2013-05-19 00:05:00 2.0 0 Percent 2013-05-19 00:06:00 2.0 0 Percent 2013-05-19 00:07:00 2.0 0 Percent 2013-05-19 00:08:00 2.0 0 Percent 2013-05-19 00:09:00 2.0 0 Percent 2013-05-19 00:10:00 2.0 0 Percent 2013-05-19 00:11:00 2.0 0 Percent 2013-05-19 00:12:00 2.0 0.195 Percent 2013-05-19 00:13:00 2.0 0.215 Percent ...
示例请求
此示例返回您的整个 EC2 队列的 CPU 利用率。
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2"
示例请求
此示例返回特定用户在 1 小时分辨率时对 MyService 的测试堆栈进行的平均、最小和最大请求计数。
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,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"
示例请求
此示例显示所有“MyService”中的 RequestCount 统计数据。
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,Maximum,SampleCount" --namespace "MyService"