閱讀477 返回首頁    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-阿裏雲