全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
云监控

查询最新监控数据

更新时间:2017-06-27 17:55:34

描述

查询指定监控对象的最新监控数据。

请求类型

GET

请求参数

名称 类型 必填 描述
Action String 操作接口名,系统规定参数,取值: QueryMetricLast
Project String 名字空间,表明监控数据所属产品,如 “acs_ecs_dashboard”,“acs_rds_dashboard”等
Metric String 监控项名称
Period String 时间间隔,统一用秒数来计算,例如 60, 300, 900。 如果不填写,则按照注册监控项时申明的上报周期来查询原始数据。如果填写统计周期,则查询对应的统计数据。
StartTime String 开始时间,可以传入距离 1970 年 1 月 1 日 0 点的毫秒数,也可以传入format数据,如2015-10-20 00:00:00。
EndTime String 可以传入距离 1970 年 1 月 1 日 0 点的毫秒数,也可以传入format数据,如2015-10-20 00:00:00。
Dimensions String 用于过滤监控数据的 key-value 集合,key 可以使用注册监控项时申明的 dimensionKeys 中的一个或多个,value 为 该 key 对应的值。instanceId 是必填项 需要使用 JSON 字符串表示该 Map 对象,传入时请使用字符串,dimension要求必须按顺序传入。
Length String 返回监控数据的每页大小,用于分页查询。默认值为1000,即每页1000条监控数据。
Cursor String 游标

各云产品的Project、Metric、Period、Dimensions等入参如何赋值,请参考预设监控项文档

返回参数

名称 类型 描述
Period String 时间间隔,统一用秒数来计算,例如 60, 300, 900。
Cursor String 游标
Datapoints List 监控数据列表,内容格式例如:{ “timestamp”: 1490164200000,”Maximum”: 100,”userId”: “1234567898765432”, “Minimum”: 4.55,”instanceId”: “i-bp18abl200xk9599ck7c”, “Average”: 93.84}
Code String 状态码,正常为”200”。
Success Boolean 否成功执行,如果服务器端有异常此返回值为false,正常为true。
Message String 状态描述信息,Code为“200”时,Message一般为空。
RequestId String 当请求出现问题时,可以提供此字段给技术人员进行问题排查。

错误编码

错误代码 描述 语义
400 Bad Request 客户端请求中的语法错误
403 Forbidden 没有权限
404 Not Found 客户端错误,未找到
500 Internal Server Error 服务器内部错误
200 OK 正常

示例

  • 请求示例
  1. http://metrics.cn-hangzhou.aliyuncs.com/?Action=QueryMetricLast
  2. &EndTime=2017-03-22+14%3A30%3A27
  3. &StartTime=2017-03-22+14%3A20%3A27
  4. &Period=60
  5. &Dimensions=%7BinstanceId%3A%27 i-abcdefgh123456%27%7D
  6. &Project=acs_ecs_dashboard
  7. &Metric=cpu_idle
  8. &<公共请求参数>
  • 返回示例

XML格式

  1. <QueryMetricLastResponse>
  2. <Period>60</Period>
  3. <Datapoints>
  4. <Datapoints>
  5. <timestamp>1490164200000</timestamp>
  6. <Maximum>100</Maximum>
  7. <userId>1234567898765432</userId>
  8. <Minimum>4.55</Minimum>
  9. <instanceId>i-bp18abl200xk9599ck7c</instanceId>
  10. <Average>93.84</Average>
  11. </Datapoints>
  12. </Datapoints>
  13. <RequestId>021472A6-25E3-4094-8D00-BA4B6A5486C3</RequestId>
  14. <Success>true</Success>
  15. <Code>200</Code>
  16. </QueryMetricLastResponse>

JSON格式

  1. {
  2. "Period": "60",
  3. "Datapoints": [
  4. {
  5. "timestamp": 1490164200000,
  6. "Maximum": 100,
  7. "userId": "1234567898765432",
  8. "Minimum": 4.55,
  9. "instanceId": "i-bp18abl200xk9599ck7c",
  10. "Average": 93.84
  11. }
  12. ],
  13. "RequestId": "4E7664F2-9CDE-4212-9318-A0712D345A5E",
  14. "Success": true,
  15. "Code": "200"
  16. }
本文导读目录