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 |