添加监控数据
功能介绍
该接口用于向服务端添加一条或多条监控数据。
URI
POST /v1/{project_id}/ams/report/metricdata
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
租户从IAM申请到的projectid，一般为32位字符串。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token。 |
Content-Type |
是 |
String |
指定类型为application/json。 枚举值：
|
X-Aom-Prometheus-Id |
否 |
String |
Prometheus实例ID，不填默认为默认prometheus实例 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
[数组元素] |
是 |
Array of MetricDataItem objects |
指标参数信息。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
collect_time |
是 |
Long |
数据收集时间支持过去1天和未来半小时范围内的数据上报。数据收集时间需要满足： 当前UTC时间减去collect_time小于等于24小时或者collect_time减去当前UTC时间小于等于30分钟。 若数据上报时间早于当天8点，则指标监控页面只显示当天8点后的数据。 取值范围： UNIX时间戳，单位毫秒。 |
metric |
是 |
RecieveMetricParam object |
指标详细信息。 |
values |
是 |
Array of RecieveMetricValues objects |
指标数据的值。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
dimensions |
是 |
Array of Dimension objects |
指标维度列表。 维度最多允许50个，单个维度为json对象，结构说明如下 dimension.name：长度最短为1，最大为32。 dimension.value：长度最短为1，最大为64。 |
namespace |
是 |
String |
指标命名空间。namespace中不允许存在":"符号，取值范围 格式为service.item；service和item必须是字符串，必须以字母开头，只能包含0-9/a-z/A-Z/_，总长度最短为3，最大为32，service不能为“PAAS”。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
errorCode |
String |
响应码。 |
errorMessage |
String |
响应信息描述。 |
请求示例
向服务端添加一条监控数据（下述例子中，"collect_time"应填写为最新的时间戳）。
POST https://{Endpoint}/v1/{project_id}/ams/report/metricdata
[ {
"metric" : {
"namespace" : "NOPAAS.ESC",
"dimensions" : [ {
"name" : "instance_id",
"value" : "instance-101"
} ]
},
"values" : [ {
"unit" : "percent",
"metric_name" : "cpu_util",
"type" : "int",
"value" : 35
} ],
"collect_time" : 1467787152000
} ]
响应示例
状态码： 200
请求响应成功。
{
"errorCode" : "SVCSTG_AMS_2000000",
"errorMessage" : "success"
}
状态码
状态码 |
描述 |
|---|---|
200 |
请求响应成功。 |
400 |
非法请求。 |
401 |
非法认证信息。 |
403 |
请求被拒绝访问。 |
500 |
服务端能被访问，但请求不合理。 |
503 |
服务不可用。 |
错误码
请参见错误码。
