mon-get-stats - Amazon CloudWatch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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]

选项

名称 描述

MetricName

指标的名称。还可以使用 --metric-name 设置此值。

类型:参数

有效值:长度介于 1 到 255 个字符之间的任何有效指标名称。

默认值:不适用

必需:是

--dimensions "key1=value1,key2=value2..."

指标的维度。可以两种方式指定维度,且格式可结合使用或互换使用:

  • 每个维度一个选项:--dimensions "key1=value1" --dimensions "key2=value2"

  • 所有维度都在一个选项中: --dimensions "key1=value1,key2=value2"

类型:映射

有效值:格式为 name=value 的字符串,其中,键是维度的名称,值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。

默认值:不适用

必需:否

--end-time VALUE

返回的数据点的最新允许时间戳。不包括结束时间。时间戳是使用 ISO8601 组合格式指定的。例如,日期和时间 2013 年 7 月 30 日 12:30:00 将表示为:2013-07-30T12:30:00-07:00(太平洋标准时间),或 2013-07-30T19:30:00Z(协调世界时)。CloudWatch 可返回的最高分辨率是 1 分钟,同样,所有时间戳向下舍入为最近的分钟。

类型:参数

有效值:采用 ISO8601 格式表示的有效时间戳,带有时区偏移或 UTC 指示符。

默认值:当前日期/时间。

必需:否

-n, --namespace VALUE

指标的命名空间。有关命名空间的更多信息,请参阅 Amazon 命名空间

类型:字符串

有效值:长度介于 1 到 250 个字符之间的有效命名空间。

默认值:不适用

必需:是

--period VALUE

要检索其统计数据的粒度(以秒为单位)。周期必须为至少为 60 秒,且必须为 60 的倍数。

类型:参数

有效值:以秒为单位的数字,是 60 秒的倍数。

默认值:60 秒。

必需:否

-s, --statistics VALUE1,VALUE2,VALUE3...

要为给定指标返回的统计数据。

类型:枚举

有效值:Average、Sum、Maximum 或 Minimum

默认值:不适用

必需:是

--start-time VALUE

返回的数据点的第一个允许时间戳。包含开始时间。时间戳是使用 ISO8601 组合格式指定的。例如,日期和时间 2013 年 7 月 30 日 12:30:00 将表示为:2013-07-30T12:30:00-07:00(太平洋标准时间),或 2013-07-30T19:30:00Z(协调世界时)。CloudWatch 可返回的最高分辨率是 1 分钟,同样,所有时间戳向下舍入为最近的分钟。

类型:参数

有效值:采用 ISO8601 格式表示的有效时间戳,带有时区偏移或 UTC 指示符。

默认值:当前时间之前的一个小时。

必需:否

--unit VALUE

要检索其指标的单位。可以用多个单位报告指标,这会检索特定单位的给定指标。不请求单位的结果将是返回所有单位。如果仅对一个单位报告指标,则无影响。

类型:枚举

有效值:下列值之一:

  • 微秒

  • 毫秒

  • 字节

  • 千字节

  • 兆字节

  • 千兆字节

  • 千吉字节

  • Bits

  • 千位

  • 兆位

  • 千兆位

  • 太位

  • 百分比

  • 计数

  • 字节/秒

  • 千字节/秒

  • 兆字节/秒

  • 千兆字节/秒

  • 千吉字节/秒

  • Bits/Second

  • 千位/秒

  • 兆位/秒

  • 千兆位/秒

  • 太位/秒

  • 计数/秒

默认值:不适用

必需:否

常用选项

名称 描述

--aws-credential-file VALUE

带有 Amazon 凭证的文件的位置。您可以使用环境变量 AWS_CREDENTIAL_FILE 设置此值。如果您定义了环境变量或提供了凭证文件的路径,则该文件必须存在,否则请求将失败。必须使用访问密钥 ID 和秘密访问密钥签署所有 CloudWatch 请求。

类型:字符串

有效值:包含访问密钥 ID 和秘密访问密钥的文件的有效路径。

默认值:使用环境变量 AWS_CREDENTIAL_FILE(如果已设置)。

-C, --ec2-cert-file-path VALUE

用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 EC2_CERT 指定此值。

类型:字符串

有效值:由 Amazon EC2 或 Amazon Identity and Access Management 提供的 PEM 文件的有效路径。

默认值:使用环境变量 EC2_CERT(如果已设置)。

--connection-timeout VALUE

连接超时值(以秒为单位)。

类型:整数

有效值:任何正数。

默认值:30

--delimiter VALUE

显示经分隔(长)结果时使用的分隔符。

类型:字符串

有效值:任意字符串。

默认值:逗号 (,)

--headers

如果要显示表格结果或分隔结果,请包括列标题。如果要显示 XML 结果,请从服务请求返回 HTTP 标头(如果适用)。

类型:标记

有效值:如果存在,则显示标头。

默认值:默认情况下,--headers 选项为关闭状态。

-I, --access-key-id VALUE

访问密钥 ID 将与私有密钥共同用于签署请求。其必须与私有密钥结合使用,否则此选项将被忽略。对 CloudWatch 的所有请求都必须签署,否则请求将被拒绝。

类型:字符串

有效值:有效访问密钥 ID。

默认值:无

-K, --ec2-private-key-file-path VALUE

将用于签署请求的私有密钥。使用公有/私有密钥会导致 CLI 使用 SOAP。此请求通过公有证书和私有密钥签署。此参数必须与 EC2_CERT 结合使用,否则此值将被忽略。环境变量 EC2_PRIVATE_KEY 的值将在设置时使用,并且未指定此选项。如果环境变量 AWS_CREDENTIAL_FILE 已设置,或 --aws-credentials-file 已使用,则此选项将被忽略。对 CloudWatch 的所有请求都必须签署,否则请求将被拒绝。

类型:字符串

有效值:有效 ASN.1 私有密钥的路径。

默认值:无

--region VALUE

定向到区域请求。您可以使用环境变量 EC2_REGION 指定该值。该区域用于创建用于调用 CloudWatch 的 URL,并且必须是有效的亚马逊云科技 (Amazon)区域。

类型:字符串

有效值:任意 Amazon 区域,例如 us-east-1。

默认值:除非 EC2_REGION 环境变量已设置,否则为 us-east-1。

S, --secret-key VALUE

将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 --access-key-id 结合使用,否则此选项将被忽略。

类型:字符串

有效值:您的访问密钥 ID。

默认值:无

--show-empty-fields

使用 (nil) 作为占位符显示空字段,以指示未请求此数据。

类型:标记

有效值:无

默认值:默认情况下不显示空字段。

--show-request

显示 CLI 用于调用 Amazon 的 URL。

类型:标记

有效值:无

原定设置值:false

--show-table, --show-long, --show-xml, --quiet

指定结果的显示方式:表格、分隔(长)、XML 或无输出(无提示)。--show-table 显示以固定列宽形式显示数据的子集;--show-long 显示以字符分隔的所有返回值;--show-xml 是服务的原始返回值;--quiet 将抑制所有标准输出。所有选项是互斥的,优先级:--show-table--show-long--show-xml--quiet

类型:标记

有效值:无

默认值:--show-table

-U, --url VALUE

用于联系 CloudWatch 的 URL。您可以使用环境变量 AWS_CLOUDWATCH_URL 设置此值。此值与 --region 共同用于创建预期的 URL。此选项将覆盖用于服务调用的 URL。

类型:字符串

有效值:有效 HTTP 或 HTTPS URL。

默认值:使用 AWS_CLOUDWATCH_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"

相关主题

下载

相关操作

相关命令