全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

上传数据

最近更新时间:2021-12-07 15:11:55

上传数据

1.接口描述

2.参数说明

3.请求示例

4.响应

1.接口描述

域名:monitor.api.ksyun.com

VPC内调用域名:monitor.internal.api.ksyun.com

接口名: PutMetricData

请求方法:POST

Version=2017-07-01

对已有指标的数据写入,或者发布新的指标。

2.参数说明

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。
其中此接口的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)`

3.请求示例

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"
    }
]

4.响应

参数名称 类型 描述
Message String 请求的返回信息。
RequestId String 请求ID,标识定位请求。

例如:

{
    "responseMetadata": {
        "requestId": "337a5f92-a2c5-4ade-8be6-18526ab5faa6"
    },
    "message": "SUCCESS"
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈