云监控

云监控

产品文档

云监控

帮助中心 > OpenAPI & SDK > 云监控 > putMetricData
搜本产品

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
feedback