最近更新时间:2021-12-07 15:11:55
域名:monitor.api.ksyun.com
VPC内调用域名:monitor.internal.api.ksyun.com
接口名: PutMetricData
请求方法:POST
Version=2017-07-01
对已有指标的数据写入,或者发布新的指标。
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。
其中此接口的Action字段为PutMetricData。推荐使用SDK
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
NameSpace | 是 | String | 命名空间;一个命名空间表示一类资源,如云服务器 |
MetricName | 是 | String | 指标名称;指标是监控的变量,监控数据是该变量随时间变化的数值,格式如:cpu.utilizition.total |
Dimensions | 是 | String | 指标对应的维度;用于说明指定资源的监控数据,Key-Value键值对形式的集合,格式如:“k1=v1”,“k2=v2” ,详见下方请求示例 |
Timestamp | 是 | String | UTC时间,格式如:2017-07-01T00:00:00Z; UTC时间,为北京时间减8小时, 如果采用北京时间,请减去8小时进行数据上传 |
Value | 是 | float64 | 指标上传的数值 |
Unit | 否 | String | 指标对应的单位 |
Unit支持:(Seconds|Microseconds|Milliseconds|Bytes|Kilobytes|Megabytes|Gigabytes|Terabytes|Bits|Kilobits|Megabits|Gigabits|Terabits|Percent|Count|Bytes/Second|Kilobytes/Second| Megabytes/Second|Gigabytes/Second| Terabytes/Second| Bits/Second| Kilobits/Second|Megabits/Second|Gigabits/Second|Terabits/Second|Count/Second|None)`
https://monitor.domain.api.ksyun.com?
Action=PutMetricData
&Version=2017-07-01
用户可以一次提交多条统计数据,数据放在消息体中,遵循 JSON 格式。
tao部门有xiaojin产品,监控该产品api_exist的内容:
[
{
"namespace": "tao",
"metricname": "api_exist",
"timestamp": "2017-07-03T12:04:00Z",
"value": 1.2,
"dimensions": [
"product=xiaojin",
"apiname=apinameA"
],
"unit": "Seconds"
},
{
"namespace": "xiaojin",
"metricname": "api_exist",
"timestamp": "2017-07-03T12:05:00Z",
"value": 0.01,
"dimensions": [
"product=xiaojin",
"apiname=apinameB"
],
"unit": "Seconds"
}
]
参数名称 | 类型 | 描述 |
---|---|---|
Message | String | 请求的返回信息。 |
RequestId | String | 请求ID,标识定位请求。 |
例如:
{
"responseMetadata": {
"requestId": "337a5f92-a2c5-4ade-8be6-18526ab5faa6"
},
"message": "SUCCESS"
}
纯净模式