上报监控数据
自定义监控功能为你提供上报监控数据的接口,方便你将自己采集的时序数据上报到云监控。目前支持OpenAPI和命令行工具CLI的方式进行上报。
OpenAPI上报上报接口描述
-
接口名称:putMetricData
-
公网域名
- 内网域名
- 支持批量上报方式。单次请求最多包含50个数据点;数据大小不超过256k。
地域域名华北-北京monitor.cn-north-1.cloud-api.com华南-广州monitor.cn-south-1.cloud-api.com华东-宿迁monitor.cn-east-1.cloud-api.com华东-上海monitor.cn-east-2.cloud-api.com
地域域名华北-北京monitor.internal.cn-north-1.cloud-api.com华南-广州monitor.internal.cn-south-1.cloud-api.com华东-宿迁monitor.internal.cn-east-1.cloud-api.com华东-上海monitor.internal.cn-east-2.cloud-api.com
注:OpenAPI入门使用请参看公共说明
请求方式
POSThttps://{域名}/v1/customMetrics
例如:POSThttps://monitor.cn-north-1.cloud-api.com/v1/customMetrics
请求参数名称类型是否必选描述metricDataListMetricDataCm[]False数据参数
MetricDataCm
名称类型是否必选描述dimensionsObjectTrue数据维度,数据类型为map类型,支持最少一个,最多五个标签,总长度不大于255字节,只允许英文、数字、下划线_、点.,[0-9][a-z][A-Z][._],其它会返回errmetricStringTrue监控指标名称,长度不超过255字节,只允许英文、数字、下划线_、点.,[0-9][a-z][A-Z][._],其它会返回errnamespaceStringTrue命名空间,长度不超过255字节,只允许英文、数字、下划线_、点.,[0-9][a-z][A-Z][._],其它会返回errtimestampIntegerTrue上报数据点的时间戳,只支持10位,秒级时间戳,不能写入过去30天的时间typeIntegerTrue数据类型,当前仅支持输入值1,表示原始数据。valuesObjectTrue指标值集合,数据类型必须为map类型,key为数据类型,value为数据值,当前仅支持type=1,且key只能为”value”。返回参数名称类型是否必选errorObject错误信息。requestIdString请求的标识idresultResult
Result
名称类型是否必选errMetricDataListMetricDataList[]successBoolean全部写入成功为true,否则为false
MetricDataList
名称类型是否必选errDetailstring错误数据描述errMetricDatastring错误数据返回码名称类型200OK400invalidparameter500internalservererror429quotaexceed示例代码
注:直接使用该示例时,请替换timestamp参数为最新的10位秒级时间戳,否则会写入失败(禁止写入时间戳超过过去30天的数据)。
请求示例
{"metricDataList":[{"namespace":"test","metric":"vm.mem.usage1","dimensions":{"host":"1.2.3.23","datacenter":"cn-north-1"},"timestamp":1552446075,"type":1,"values":{"value":"12342213"}},{"namespace":"test1","metric":"vm.cpu.usage","dimensions":{"host":"1.2.3.19","tag":"bj"},"timestamp":1552446075,"type":2,"values":{"value":"12342213"}}]}
返回示例
success:{"requestId":"1111","result":{"success":true,"errMetricDataList":[]}}fail:{"requestId":"1111","result":{"success":false,"errMetricDataList":[{"ErrMetricData":"{"namespace":"test1","metric":"vm.cpu.usage","dimensions":{"host":"1.2.3.19","region":"bj","tag":"bj","tag2":"bj","tag3":"bj","tag4":"bj"},"timestamp":1540361379,"type":2,"values":{"avg":"80","max":"32424244120"}}","errDetail":"Invaliddimensions,dimensionsnumlimitedin1to5andnotnull"}]},"error":{"code":400,"message":"INVALID_ARGUMENT","status":"INVALID_ARGUMENT","details":null}}CLI上报安装CLI
如何安装请参看安装说明。
配置环境
配置KEY、所在区域region-id和网关地址endpoint,编辑/root/.c/config
vi~/.c/config[default]access_key=YourAccessKeyIDsecret_key=YourAccessKeySecretregion_id=cn-north-1endpoint=monitor.cn-north-1.cloud-api.comscheme=httpstimeout=20不同地域的region_id和上报的网关endpoint地址如下:地域region_id公网endpoint内网endpoint华北-北京cn-north-1monitor.cn-north-1.cloud-api.commonitor.internal.cn-north-1.cloud-api.com华南-广州cn-south-1monitor.cn-south-1.cloud-api.commonitor.internal.cn-south-1.cloud-api.com华东-宿迁cn-east-1monitor.cn-east-1.cloud-api.commonitor.internal.cn-east-1.cloud-api.com华东-上海cn-east-2monitor.cn-east-2.cloud-api.commonitor.internal.cn-east-2.cloud-api.com
上报监控数据
使用put-metric-data接口上报监控数据,示例如下:
cmonitorput-metric-data--input-json'{"metricDataList":[{"namespace":"test_ns","metric":"vm.cpu.usage1","dimensions":{"host":"10.10.10.23","datacenter":"cn_north_1"},"timestamp":1544425695,"type":1,"values":{"value":"12342213"}}]}'注意:仅能上报近1周的监控数据,请将上边示例中timestamp中的时间戳修改为你当前上报的UNIX时间。
返回成功示例如下:
{"error":null,"result":{"errMetricDataList":[],"success":true},"request_id":"bg9ofp78ikqqgvastas64owpqmoijk77"}