自定义监控-推送数据接口
更新时间：2026-01-12
自定义指标推送接口描述
将数据推送至BCM进行监控。您在使用自定义监控功能时，可通过此接口将时序数据推送至BCM进行实时监控。
！！重要
自2025年12月23日起，自定义监控模块停止对新用户服务，存量用户可继续使用。 1.影响范围：本次下线模块为自定义监控，对新用户将进行隐藏处理 2.功能迁移方案：上述下线功能建议使用百度智能云Prometheus监控替代
请求结构
- 请求方法：POST
- URL：/csm/api/v1/userId/{userId}/custom/data
- URL参数以及请求body请参考下面的参数列表以及请求示例
参数列表
URL参数
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| userId | String | 租户ID | 是 |
RequestBody参数
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| namespace | String | 名字空间 | 是 |
| metricName | String | 监控项名称 | 是 |
| dimensions | List<Dimension> | 维度 | 是 |
| value | double | 监控项取值 | 是 |
| timestamp | String | 时间 | 是 |
Dimension
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| name | String | 维度名 | 是 |
| value | String | 维度值 | 是 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求标识 |
| code | String | 返回码 |
| message | String | 返回信息 |
请求示例
Plain Text
1POST /csm/api/v1/userId/user1/custom/data HTTP/1.1
2Host:bcm.bj.baidubce.com:80
3
4{
5 "namespace":"namespace1",
6 "metricName": "pv",
7 "dimensions": [
8 {
9 "name": "dimension1",
10 "value": "myMachine"
11 },
12 {
13 "name": "dimension2",
14 "value": "myService"
15 }
16 ],
17 "value": 123,
18 "timestamp": "2020-12-31T08:00:00Z"
19} 响应示例
失败响应示例
Plain Text
1{
2 "requestId": "45113fb2-fe84-411f-809b-9383d43003cd",
3 "code": "ParameterValueException",
4 "message": "The request param metricName pv of saverMetricData SaverMetricData(namespace=namespace1, metricName=pv, dimensions=[dimension1:myMachine,dimension2:myMachine], value=123, statisticValues=null, timestamp=2020-12-31T08:00:00Z) isvalid."
5}