本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
mon-put-data
Description
向指定的指标添加指标数据点。此调用将放置给定指标名称的原始值或有效统计数据值的时间序列数据。它支持一次输入一个数据点。
当您使用 mon-put-data
命令创建新的指标时,可能需要两分钟时间,之后方可使用 mon-get-stats
命令在新的指标上检索统计信息。但是,这可能需要最多 15 分钟时间,之后新的指标会出现在使用 mon-list-metrics
命令检索的指标列表中。
Syntax
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]
Options
名称 | 描述 |
---|---|
-d, --dimensions "key1=value1,key2=value2..." |
唯一标识指标数据的维度。可以两种方式指定维度,且格式可结合使用或互换使用:
类型: 映射 有效值:格式 name=value 的字符串,其中键是维度的名称,值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。 默认值:不适用 必需:否 |
|
指标的名称。 类型: 字符串 有效值:任何介于 1 到 250 个字符之间的有效指标名称。 默认值:不适用 必需:是 |
|
指标的命名空间。有关命名空间的更多信息,请参阅 AWS 命名空间。 类型: 字符串 有效值:长度介于 1 到 250 个字符之间的 ANSI 字符串。 默认值:不适用 必需:是 |
|
要为指定的时间戳和指标存储的统计数据。此选项是 类型: 映射 有效值:包含所有统计名称的所有双精度值的字符串:SampleCount 、Sum、Maximum 和 Minimum。所有这些值都必须是介于 1E-130 和 1E130 之间的值。 默认值:不适用 必需:是 |
|
数据点的时间戳或要记录的指标的观察。时间戳是使用 ISO8601 组合格式指定的。例如,日期和时间 2013 年 7 月 30 日 12:30:00 PST 将表示为 2013-07-30T12:30:00-07:00 或 UTC:2013-07-30T19:30:00Z。 类型: 简便 有效值:采用 ISO8601 格式表示的有效时间戳,带有时区偏移或 UTC 指示符。 默认值:当前 UTC 时间。 必需:否 |
|
指标的单位。 类型: 枚举 有效值:下列情况之一:
默认值:不适用 必需:否 |
|
待记录的单个值。该值将转换为以下形式的统计数据集:SampleCount = 1、Sum=VALUE、Minimum=VALUE、Maximum=VALUE。此选项是
类型: 简便 有效值:所有值必须是介于 1E-130 和 1E130 之间的数字。 默认值:不适用 必需:是 |
常用选项
名称 | 说明 |
---|---|
|
带有 AWS 凭证的文件位置。您可以使用 类型:字符串 有效值:包含访问密钥 ID 和秘密访问密钥的文件的有效路径。 默认:使用 |
|
用于对请求进行签名的 EC2 证书文件的位置。您可以使用环境变量 类型:字符串 有效值:Amazon EC2 或 AWS Identity and Access Management 提供的 PEM 文件的有效文件路径。 默认:使用 |
|
连接超时值(按秒计)。 类型:整数 有效值:任意正数。 默认值:30 |
|
显示带分隔符(长整型)结果时使用的分隔符。 类型:字符串 有效值:任意字符串。 默认值:逗号 (,) |
|
如果您正在显示表格式或带分隔符的结果,则包括列标题。如果您正在显示 XML 结果,则通过服务请求返回 HTTP 标头(如适用)。 类型:标志 有效值:存在时显示标头。 默认值: |
|
将与秘密密钥结合使用对请求进行签名的访问密钥 ID。它必须与 --secret-key 结合使用,否则将忽略该选项。必须对所有 CloudWatch 请求进行签名,否则请求将被拒绝。 类型:字符串 有效值:有效的访问密钥 ID。 默认值:无 |
|
将用于对请求进行签名的私钥。使用公钥/私钥会导致 CLI 使用 SOAP。使用公共证书和私钥对请求进行签名。此参数必须与 类型:字符串 有效值:有效 ASN.1 私钥的路径。 默认值:无 |
|
请求被定向到的区域。您可以使用环境变量 类型:字符串 有效值:任何 AWS 区域,例如 us-east-1。 默认:us-east-1,除非已设置 |
|
将与访问密钥 ID 结合使用来对请求进行签名的秘密访问密钥。此参数必须与 类型:字符串 有效值:访问密钥 ID。 默认值:无 |
|
使用 (nil) 作为占位符显示空字段,以指示未请求此数据。 类型:标志 有效值:无 默认值:默认情况下不显示空字段。 |
|
显示 CLI 用于调用 AWS 的 URL。 类型:标志 有效值:无 默认值:false |
|
指定显示结果的方式:表格、带分隔符(长整型)、XML 或无输出(秘密型)。 类型:标志 有效值:无 默认值: |
|
用于联系 CloudWatch 的 URL。您可以使用 类型:字符串 有效值:有效的 HTTP 或 HTTPS URL。 默认值:使用 |
Output
此命令向指标添加指标数据点。
Amazon CloudWatch CLI 在 stderr 上显示错误。
Examples
示例请求
此示例将 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