调用PutCustomMetric接口上报自定义监控数据。
接口说明
推荐您使用企业云监控中的接口 PutHybridMonitorMetricData 。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
cms:PutCustomMetric |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| MetricList |
array<object> |
是 |
监控数据列表。 |
|
|
object |
否 |
|||
| Type |
string |
是 |
上报数值类型。N 的取值范围：1~21。取值：
说明
当上报聚合数据时，建议周期为 60 秒和 300 秒的数据均上报，否则无法正常查询跨度大于 7 天的监控数据。 |
0 |
| MetricName |
string |
是 |
监控项名称。N 的取值范围：1~21。详情请参见云服务监控项。 |
cpu_total |
| Time |
string |
否 |
指标发生的时间。N 的取值范围：1~21。支持以下两种类型：
|
1508136760000 |
| GroupId |
string |
是 |
应用分组 ID。N 的取值范围：1~21。 说明
如果监控项不属于任何应用分组， 则输入 0。 |
12345 |
| Values |
string |
是 |
指标值集合。N 的取值范围：1~21。 说明
如果上报数值的类型为 0，则上报的是原始值，云监控会按周期将原始值聚合为多个值，例如：最大、计数、求和等。 |
{"value":10.5} |
| Dimensions |
string |
是 |
维度 Map，用于查询指定资源的监控数据。N 的取值范围：1~21。 格式：key-value 键值对形式的集合，常用的 key-value 集合为： Key 和 Value 的长度为 1~64 个字符，超过 64 个字符时截取前 64 个。 Key 和 Value 的取值可包含英文字母、数字、点号（.）、短划线（-）、下划线（_）、正斜线（/）和反斜线（\）。 说明
Dimensions 传入时需要使用 JSON 字符串表示该 Map 对象，必须按顺序传入。 |
{"sampleName1":"value1","sampleName2":"value2"} |
| Period |
string |
否 |
聚合周期。N 的取值范围：1~21。单位：秒，取值：60 或 300。 说明
如果上报数值的类型为 1，则需要设置该参数。 |
60 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Code |
string |
状态码。 说明
200 表示成功。 |
200 |
| Message |
string |
错误信息。 |
The request has failed due to a temporary failure of the server. |
| RequestId |
string |
请求 ID。 |
05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0 |
示例
正常返回示例
JSON格式
{
"Code": "200",
"Message": "The request has failed due to a temporary failure of the server.",
"RequestId": "05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | %s | %s | |
| 500 | %s | %s | |
| 500 | InternalError | %s | |
| 403 | %s | %s | |
| 404 | %s | %s |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。