开发者社区> 问答> 正文

云监控查询最新监控数据


描述
查询指定监控对象的最新监控数据。
请求类型
GET
请求参数

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

各云产品的Project、Metric、Period、Dimensions等入参如何赋值,请参考 预设监控项文档
返回参数
名称类型描述
PeriodString时间间隔,统一用秒数来计算,例如 60, 300, 900。
CursorString游标
DatapointsList监控数据列表,内容格式例如:{ “timestamp”: 1490164200000,”Maximum”: 100,”userId”: “1234567898765432”, “Minimum”: 4.55,”instanceId”: “i-bp18abl200xk9599ck7c”, “Average”: 93.84}
CodeString状态码,正常为”200”。
SuccessBoolean否成功执行,如果服务器端有异常此返回值为false,正常为true。
MessageString状态描述信息,Code为“200”时,Message一般为空。
RequestIdString当请求出现问题时,可以提供此字段给技术人员进行问题排查。

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

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

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

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

展开
收起
反向一觉 2017-10-31 13:48:28 2487 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
ARMS 智能告警套件最佳实践 立即下载
智能告警:IT系统神经中枢 立即下载
阿里云应用性能管理(APM)产品-应用实时监控服务(ARMS 立即下载