
# 创建上报服务指标
#### 功能介绍
创建上报到仪表盘的服务指标。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-servicestage/servicestage_06_0008.html)。
#### URI
POST /v2/{project_id}/csemonitor/metric
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                     |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户子项目的唯一标识。字符长度为1\~64。 |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| x-domain-name | 是    | String | 租户账号名称。  |
| X-Auth-Token  | 是    | String | 用户Token。 |
   
表3请求Body参数 
| 参数         | 是否必选 | 参数类型                                                                                     | 描述      |
|:---|:---|:---|:---|
| name       | 否    | String                                                                                   | 名称      |
| appId      | 否    | String                                                                                   | 应用ID    |
| serviceId  | 否    | String                                                                                   | 服务ID    |
| version    | 否    | String                                                                                   | 版本      |
| instanceId | 否    | String                                                                                   | 实例ID    |
| instance   | 否    | String                                                                                   | 实例信息    |
| thread     | 否    | Integer                                                                                  | 线程名称    |
| cpu        | 否    | Double                                                                                   | CPU信息   |
| memory     | 否    | Map\<String, Long\>                                                                      | 内存信息    |
| interfaces | 否    | Array of [FunctionMetricInfo] objects | 监控项信息列表 |
   
 表4FunctionMetricInfo 
| 参数                 | 是否必选 | 参数类型    | 描述            |
|:---|:---|:---|:---|
| functionName       | 否    | String  | 监控项名称         |
| functionType       | 否    | String  | 监控项类型         |
| desc               | 否    | String  | 监控项描述         |
| time               | 否    | Long    | 时间            |
| appId              | 否    | String  | 应用ID          |
| version            | 否    | String  | 版本            |
| qps                | 否    | Double  | 吞吐量           |
| latency            | 否    | Double  | 时延            |
| rate               | 否    | Double  | 占比            |
| failureRate        | 否    | Double  | 失败占比          |
| shortCircuited     | 否    | Integer | 熔断次数          |
| semaphoreRejected  | 否    | Integer | 信号量拒绝次数       |
| threadPoolRejected | 否    | Integer | 线程池拒绝次数       |
| countTimeout       | 否    | Integer | 超时时间          |
| l995               | 否    | Double  | 99.5%的请求低于此值。 |
| l99                | 否    | Double  | 99%的请求低于此值。   |
| l90                | 否    | Double  | 90%的请求低于此值。   |
| l75                | 否    | Double  | 75%的请求低于此值。   |
| l50                | 否    | Double  | 50%的请求低于此值。   |
| l25                | 否    | Double  | 25%的请求低于此值。   |
| l5                 | 否    | Double  | 5%的请求低于此值。    |
   
#### 响应参数
**状态码： 400**
表5响应Body参数 
| 参数           | 参数类型   | 描述      |
|:---|:---|:---|
| errorCode    | String | 错误代码。   |
| errorMessage | String | 错误信息。   |
| detail       | String | 详细定位信息。 |
   
**状态码： 500**
表6响应Body参数 
| 参数           | 参数类型   | 描述      |
|:---|:---|:---|
| errorCode    | String | 错误代码。   |
| errorMessage | String | 错误信息。   |
| detail       | String | 详细定位信息。 |
   
#### 请求示例
```
POST https://{endpoint}/v2/{project_id}/csemonitor/metric
{
  "name" : "test",
  "appId" : "default",
  "version" : "1.0.0",
  "instance" : "hostNameTest",
  "thread" : 0,
  "cpu" : 0,
  "memory" : {
      "1":"1"
  },
  "interfaces" : [
      {
        "time" : 0,
        "name" : "test",
        "qps" : 0,
        "latency" : 0,
        "rate" : 0,
        "total" : 0,
        "isCircuitBreakerOpen" : true,
        "failure" : 0,
        "shortCircuited" : 0,
        "semaphoreRejected" : 0,
        "threadPoolRejected" : 0,
        "countTimeout" : 0,
        "l995" : 0,
        "l99" : 0,
        "l90" : 0,
        "l75" : 0,
        "l50" : 0,
        "l25" : 0,
        "l5" : 0
      }
    ]
}
```
#### 响应示例
**状态码： 400**
```
{
  "errorCode" : "string",
  "errorMessage" : "string",
  "detail" : "string"
}
```
**状态码： 500**
```
{
  "errorCode" : "string",
  "errorMessage" : "string",
  "detail" : "string"
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 数据上报成功。 |
| 400 | 错误的请求。  |
| 500 | 服务内部错误  |
   
#### 错误码
请参见[CSE错误码](https://support.huaweicloud.com/api-servicestage/cse_06_0136.html)。
