响应消息

• 响应参数

  表5 响应参数

  名称	参数类型	说明
  metrics	Arrays of objects	指标数据。 详细参数请参见表6。

  表6 metrics字段数据结构说明

  名称	参数类型	说明
  unit	String	指标单位。
  datapoints	Arrays of objects	指标数据列表。由于查询数据时，云监控会根据所选择的聚合粒度向前取整from参数，所以datapoints中包含的数据点有可能会多于预期，最多返回3000个数据点。 详细参数请参见表8。
  namespace	String	指标命名空间，格式为service.item；service和item必须是字符串，必须以字母开头，只能包含0-9/a-z/A-Z/_，service.item总长度最短为3，最大为32。
  dimensions	Arrays of objects	指标维度列表。 单个维度为json对象，结构说明如下： { "name": "instance_id", "value": "33328f02-3814-422e-b688-bfdba93d4050" } 详细参数请参见表7。
  metric_name	String	指标名称，必须以字母开头，只能包含0-9/a-z/A-Z/_，长度最短为1，最大为64。

  表7 dimensions字段数据结构说明

  名称	参数类型	说明
  name	String	监控维度名称，例如弹性云服务器的维度为instance_id。各服务维度请参考支持监控的服务列表，可参考维度中key字段。 必须以字母开头，只能包含0-9/a-z/A-Z/_/-，长度最短为1，最大为32。
  value	String	维度取值，例如弹性云服务器的ID。 必须以字母或数字开头，只能包含0-9/a-z/A-Z/_/-，长度最短为1，最大为256。

  表8 datapoints字段数据结构说明

  名称	参数类型	说明
  average	Double	聚合周期内指标数据的平均值。
  max	Double	聚合周期内指标数据的最大值。
  min	Double	聚合周期内指标数据的最小值。
  sum	Double	聚合周期内指标数据的求和值。
  variance	Double	聚合周期内指标数据的方差。
  timestamp	Long	指标采集时间，UNIX时间戳，单位毫秒。

• 响应样例
  响应样例一：维度是instance_id为faea5b75-e390-4e2b-8733-9226a9026070的弹性云服务器的监控数据cpu_util的平均值和维度是instance_id为06b4020f-461a-4a52-84da-53fa71c2f42b的弹性云服务器的监控数据network_vm_connections的平均值。

  {
      "metrics": [
          {
              "namespace": "SYS.ECS",
              "metric_name": "cpu_util",
              "dimensions": [
                  {
                      "name": "instance_id",
                      "value": "faea5b75-e390-4e2b-8733-9226a9026070"
                  }
              ],
              "datapoints": [
                  {
                      "average": 0.69,
                      "timestamp": 1556625610000
                  },
                  {
                      "average": 0.7,
                      "timestamp": 1556625715000
                  }
              ],
              "unit": "%"
          },
          {
              "namespace": "SYS.ECS",
              "metric_name": "network_vm_connections",
              "dimensions": [
                  {
                      "name": "instance_id",
                      "value": "06b4020f-461a-4a52-84da-53fa71c2f42b"
                  }
              ],
              "datapoints": [
                  {
                      "average": 1,
                      "timestamp": 1556625612000
                  },
                  {
                      "average": 3,
                      "timestamp": 1556625717000
                  }
              ],
              "unit": "count"
          }
      ]
  }

  响应样例二：维度是rds_cluster_id为3c8cc15614ab46f5b8743317555e0de2in01的关系性数据库和维度是rds_cluster_id为3b2fa8b55a9b4adca3713962a9d31884in01的关系性数据库的监控数据rds021_myisam_buf_usage的求和值。

  {
      "metrics": [
          {
              "unit": "Ratio",
              "datapoints": [
                  {
                      "sum": 0.07,
                      "timestamp": 1556625628000
                  },
                  {
                      "sum": 0.07,
                      "timestamp": 1556625688000
                  }
              ],
              "namespace": "SYS.RDS",
              "dimensions": [
                  {
                      "name": "rds_cluster_id",
                      "value": "3c8cc15614ab46f5b8743317555e0de2in01"
                  }
              ],
              "metric_name": "rds021_myisam_buf_usage"
          },
          {
              "unit": "Ratio",
              "datapoints": [
                  {
                      "sum": 0.06,
                      "timestamp": 1556625614000
                  },
                  {
                      "sum": 0.07,
                      "timestamp": 1556625674000
                  }
              ],
              "namespace": "SYS.RDS",
              "dimensions": [
                  {
                      "name": "rds_cluster_id",
                      "value": "3b2fa8b55a9b4adca3713962a9d31884in01"
                  }
              ],
              "metric_name": "rds021_myisam_buf_usage"
          }
      ]
  }

  响应样例三：维度是instance_id为cd841102-f6b1-407d-a31f-235db796dcbb和proc为b28354b543375bfa94dabaeda722927f的主机监控的监控数据rds021_myisam_buf_usage的最小值。

  {
      "metrics": [
          {
              "unit": "Ratio",
              "datapoints": [
                  {
                      "min": 0,
                      "timestamp": 1556625612000
                  },
                  {
                      "min": 0,
                      "timestamp": 1556625672000
                  }
              ],
              "namespace": "AGT.ECS",
              "dimensions": [
                  {
                      "name": "instance_id",
                      "value": "cd841102-f6b1-407d-a31f-235db796dcbb"
                  },
                  {
                      "name": "proc",
                      "value": "b28354b543375bfa94dabaeda722927f"
                  }
              ],
              "metric_name": "rds021_myisam_buf_usage"
          }
      ]
  }