阅读477 返回首页    go 阿里云 go 技术社区[云栖]


CID 投递统计__发布订阅统计接口_Open API_消息队列 MQ-阿里云

本文档介绍 OnsTrendGroupOutputTps 接口,调用该接口可以查询指定 Consumer ID 在一段时间内获消费消息的统计信息。

1.使用场景

线上环境生成消费数据报表时,可以根据该接口查询消费消息的数量或者 TPS 统计。

查询场景:

  • 查询消费总量曲线的统计
  • 查询消费 TPS 曲线的统计

如果应用方消息量比较小,间隔不均匀,此时采用 TPS 查询可能会导致数据不明显,建议使用总量查询。

2. 请求参数列表

名称 类型 是否必须 描述
OnsRegionId String 当前查询 MQ 所在区域,可以通过 OnsRegionList 方法获取
OnsPlatform String 该请求来源,默认是从 POP 平台
PreventCache Long 用于 CSRF 校验,设置为系统当前时间即可
Topic String 需要查询的 Topic 名称
ConsumerId String 需要查询的 CID 名称
BeginTime Long 查询区间起始毫秒时间戳
EndTime Long 查询区间终止毫秒时间戳
Period Long 采样周期,单位分钟,支持(1,5,10)
Type Integer 查询的类型(0代表总量,1代表TPS)

3. 返回参数列表

名称 类型 描述
RequestId String 为公共参数,每个请求独一无二
HelpUrl String 帮助链接
data Data 数据集合

Data 数据集定义

名称 类型 描述
Title String table 的名称
Records List(StatsDataDo) 采集点信息

StatsDataDo 数据集定义

名称 类型 描述
X Long 横轴,毫秒时间戳
Y Float 纵轴,数据(TPS 或者总量)

4. 相关 API

  • OnsTrendTopicInputTps:查询消息写入的统计信息

5. 使用示例

调用示例

  1. public static void main(String []args) {
  2. String regionId = "cn-hangzhou";
  3. String accessKey = "XXXXXXXXXXXXXXXXX";
  4. String secretKey = "XXXXXXXXXXXXXXXXX";
  5. String endPointName ="cn-hangzhou";
  6. String productName ="Ons";
  7. String domain ="ons.cn-hangzhou.aliyuncs.com";
  8. /**
  9. *根据自己需要访问的区域选择Region,并设置对应的接入点
  10. */
  11. try {
  12. DefaultProfile.addEndpoint(endPointName,regionId,productName,domain);
  13. } catch (ClientException e) {
  14. e.printStackTrace();
  15. }
  16. IClientProfile profile= DefaultProfile.getProfile(regionId,accessKey,secretKey);
  17. IAcsClient iAcsClient= new DefaultAcsClient(profile);
  18. OnsTrendGroupOutputTpsRequest request =new OnsTrendGroupOutputTpsRequest();
  19. request.setOnsRegionId("cn-qingdao-publictest");
  20. request.setPreventCache(System.currentTimeMillis());
  21. request.setAcceptFormat(FormatType.JSON);
  22. request.setTopic("MingduanTestAPI");
  23. request.setConsumerId("CID_Mingduan");
  24. request.setBeginTime(System.currentTimeMillis()-4*3600*1000);
  25. request.setEndTime(System.currentTimeMillis());
  26. request.setPeriod(1);
  27. request.setType(0);
  28. try {
  29. OnsTrendGroupOutputTpsResponse response =iAcsClient.getAcsResponse(request);
  30. OnsTrendGroupOutputTpsResponse.Data data =response.getData();
  31. System.out.println(data.getTitle()+"n"+
  32. data.getRecords());
  33. } catch (ClientException e) {
  34. e.printStackTrace();
  35. }

最后更新:2016-11-23 18:56:39

  上一篇:go Topic 写入统计__发布订阅统计接口_Open API_消息队列 MQ-阿里云
  下一篇:go 创建授权__资源授权接口_Open API_消息队列 MQ-阿里云