云监控BCM

    推送数据接口

    接口描述

    将数据推送至BCM进行监控。您在使用自定义监控功能时,可通过此接口将数据推送至BCM进行实时监控。

    使用限制

    目前,仅北京、广州、苏州、香港Region可使用自定义监控功能,其他Region不支持此功能。

    请求结构

    • 请求方法:POST
    • URL:/json-api/v1/metricdata/{userid}/{scope}
    • 请求body请参考下面的请求参数以及请求示例

    请求参数

    名称 类型 描述 是否必须 参数位置
    userId String 租户ID URL参数
    scope String,仅限于使用如下字符集合:"0~9、A~Z、a~z"、 "_" 名字空间 URL参数
    metricData List<MetricDatum> 监控项数据 RequestBody参数

    MetricDatum

    名称 类型 描述 是否必须
    metricName String 监控项名称
    dimensions List<Dimension> 维度
    value double 监控项取值
    timestamp String 时间

    Dimension

    名称 类型 描述 是否必须
    name String 维度名
    value String 维度值

    响应参数

    名称 类型 描述
    requestId String 请求标识
    code String 返回码
    message String 返回信息

    请求示例

    POST  /json-api/v1/metricdata/user1/UserDefined_BCC  HTTP/1.1  
    Host:bcm.bj.baidubce.com:80  
    {
        "metricData": [
            {
                "metricName": "pv",
                "dimensions": [
                    {
                        "name": "os",
                        "value": "centos"
                    },
                    {
                        "name": "serviceName",
                        "value": "myService"
                    }
                ],
                "value": 1234567,
                "timestamp": "2014-05-26T07:30:00Z"
            },
            {
                "metricName": "responseTime",
                "dimensions": [
                    {
                        "name": "os",
                        "value": "windows"
                    },
                    {
                        "name": "serviceName",
                        "value": "myService"
                    }
                ],
                "value": 1234568,
                "timestamp": "2014-05-26T07:30:00Z"
            }
        ]
    }

    响应示例

    成功响应示例

    {
        "requestId": "45113fb2-fe84-411f-809b-9383d43003cd",
        "code": "OK",
        "message": ""
    }

    失败响应示例

    {
        "requestId": "45113fb2-fe84-411f-809b-9383d43003cd",
        "code": "INVALID_PARAMETER_VALUE",
        "message": "Metric data required"
    }
    上一篇
    查询数据接口
    下一篇
    云产品监控项及参数