产品文档

云监控

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
更新时间:2019-07-10 16:06:31