putMetricData
描述
该接口为自定义监控数据上报的接口，方便您将自己采集的时序数据上报到云监控。不同region域名上报不同region的数据，参考：调用说明可上报原始数据和已聚合的统计数据。支持批量上报方式。单次请求最多包含 50 个数据点；数据大小不超过 256k。
请求方式
POST
请求地址
https://monitor.{regionId}.jdcloud-api.com/v1/customMetrics
请求参数
| 名称 |
类型 |
是否必需 |
默认值 |
描述 |
| metricDataList |
MetricDataCm[ ] |
False |
|
数据参数 |
MetricDataCm
| 名称 |
类型 |
是否必需 |
默认值 |
描述 |
| namespace |
String |
True |
|
命名空间 ，长度不超过255字节，只允许英文、数字、下划线_、点., [0-9][a-z] [A-Z] [. _ ]， 其它会返回err |
| metric |
String |
True |
|
监控指标名称，长度不超过255字节，只允许英文、数字、下划线_、点., [0-9][a-z] [A-Z] [. _ ]， 其它会返回err |
| dimensions |
Object |
True |
|
数据维度，数据类型为map类型，支持最少一个，最多6个标签，总长度不大于1024字节，只允许英文、数字、下划线_、点., [0-9][a-z] [A-Z] [. _ ]， 其它会返回err。eg:{"host":"127.0.0.1","region":"cn-north-1","role":"M"} |
| timestamp |
Long |
True |
|
上报数据点的时间戳,只支持10位，秒级时间戳，不能写入过去30天的时间 |
| type |
Integer |
True |
|
数据上报类型，1为原始值，2为聚合数据。当上报聚合数据时，建议为60s的周期时行上报、否则无法正常查询 |
| values |
Object |
True |
|
指标值集合，数据类型必须为map类型，key为数据类型，value为数据值，当type=1时，key只能为”value”，上报的是原始值，当type=2时，K的值可以为"avg","sum","last","max","min","count"，只支持以上类型，否则会报错，value内容为整型或浮点型数字，最大值为9223372036854775807，count只支持>=0的数 |
| unit |
String |
False |
|
数据的单位，长度不超过64字节，只允许英文、数字、下划线_、点., [0-9][a-z] [A-Z] [. _ ]， 其它会返回err |
返回参数
| 名称 |
类型 |
描述 |
| result |
Result |
|
| requestId |
String |
请求的标识id |
| error |
Object |
错误信息 |
Result
| 名称 |
类型 |
描述 |
| success |
Boolean |
全部写入成功为true，否则为false |
| errMetricDataList |
MetricDataList[ ] |
|
MetricDataList
| 名称 |
类型 |
描述 |
| errMetricData |
String |
错误数据 |
| errDetail |
String |
错误数据描述 |
返回码
| 返回码 |
描述 |
| 200 |
OK |
| 400 |
invalid parameter |
| 429 |
quota exceed |
| 500 |
internal server error |