mon-put-data - Amazon CloudWatch
说明语法选项常用选项输出示例相关主题
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

mon-put-data

说明

向指定的指标添加指标数据点。此调用将放置给定指标名称的原始值或有效统计数据值的时间序列数据。它支持一次输入一个数据点。

注意

当您使用 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..."

唯一标识指标数据的维度。可以两种方式指定维度，且格式可结合使用或互换使用：

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

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

类型：映射

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

默认值：不适用

必需：否

-m, --metric-name VALUE1,VALUE2,VALUE3...

指标的名称。

类型：字符串

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

默认值：不适用

必需：是

n, --namespace VALUE

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

类型：字符串

有效值：长度介于 1 到 250 个字符之间的任何 ANSI 字符串。

默认值：不适用

必需：是

-s, --statistic Values "key1=value1,key2=value2..."

要为指定的时间戳和指标存储的统计数据。此选项是 --value 专用的。至少必须指定 --statisticValue 或 --value 之一。

类型：映射

有效值：包含所有统计数据名称的所有双精度值的字符串：SampleCount、Sum、Maximum 和 Minimum。所有这些值都必须是介于 1E-130 和 1E130 之间的值。

默认值：不适用

必需：是

-t, --timestamp VALUE

数据点的时间戳或要记录的指标的观察。时间戳是使用 ISO8601 组合格式指定的。例如，日期和时间 2013 年 7 月 30 日 12:30:00 将表示为：2013-07-30T12:30:00-07:00（太平洋标准时间），或 2013-07-30T19:30:00Z（协调世界时）。

类型：简单

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

默认值：当前 UTC 时间。

必需：否

-u, --unit VALUE

指标的单位。

类型：枚举

有效值：下列值之一：

  • Seconds

  • 微秒

  • 毫秒

  • 字节

  • 千字节

  • 兆字节

  • 千兆字节

  • 千吉字节

  • Bits

  • 千位

  • 兆位

  • 千兆位

  • 太位

  • 百分比

  • Count

  • Bytes/Second

  • 千字节/秒

  • 兆字节/秒

  • 千兆字节/秒

  • 千吉字节/秒

  • Bits/Second

  • 千位/秒

  • 兆位/秒

  • 千兆位/秒

  • 太位/秒

  • Count/Second

  • 无

默认值：不适用

必需：否

-v, --value VALUE

待记录的单个值。该值将转换为以下形式的统计数据集：SampleCount=1，Sum=VALUE，Minimum=VALUE，Maximum=VALUE。此选项是 --statisticValues 专有的。

类型：简单

有效值：所有值必须是介于 1E-130 和 1E130 之间的数字。

默认值：不适用

必需：是

常用选项

名称 说明

--aws-credential-file VALUE

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

类型：字符串

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

默认：使用 AWS_CREDENTIAL_FILE 环境变量（若已设置）。

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

用于对请求进行签名的 EC2 证书文件的位置。您可以使用环境变量 EC2_CERT 来指定该值。

类型：字符串

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

默认：使用 EC2_CERT 环境变量（若已设置）。

--connection-timeout VALUE

连接超时值（按秒计）。

类型：整数

有效值：任意正数。

默认值：30

--delimiter VALUE

显示带分隔符（长整型）结果时使用的分隔符。

类型：字符串

有效值：任意字符串。

默认值：逗号 (,)

--headers

如果您正在显示表格式或带分隔符的结果，则包括列标题。如果您正在显示 XML 结果，则通过服务请求返回 HTTP 标头（如适用）。

类型：标志

有效值：存在时显示标头。

默认值：--headers 选项默认处于关闭状态。

-I, --access-key-id VALUE

将与秘密密钥结合使用对请求进行签名的访问密钥 ID。它必须与 --secret-key 结合使用，否则将忽略该选项。必须对所有 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 Web Services (AWS) 区域。

类型：字符串

有效值：任何 AWS 区域，例如 us-east-1。

默认：us-east-1，除非已设置 EC2_REGION 环境变量。

S, --secret-key VALUE

将与访问密钥 ID 结合使用来对请求进行签名的秘密访问密钥。此参数必须与 --access-key-id 结合使用，否则将忽略该选项。

类型：字符串

有效值：访问密钥 ID。

默认值：无

--show-empty-fields

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

类型：标志

有效值：无

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

--show-request

显示 CLI 用于调用 AWS 的 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 中指定的值（如果已设置）。

输出

此命令向指标添加指标数据点。

Amazon CloudWatch CLI 在 stderr 上显示错误。

示例

示例请求

此示例将 RequestCount 的统计数据放在 MyService 命名空间中。该指标不包含维度，因此代表整个服务的总 RequestCount。测量值是预整合的 statisticValue，表示五个较早的测量值，其最大值是 70，最小值为 30，总和为 250。 

mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"

示例请求

此示例将用户特定的 RequestCount 测试数据放在 MyService 命名空间中。用户和堆栈名称存储为维度，以便将该指标与上面的示例中的服务范围的指标区分开。 

mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50

相关主题

下载

相关操作

相关命令