全部產品
Search
文件中心

ApsaraMQ for MQTT:軌跡查詢

更新時間:Jun 30, 2024

本文介紹如何使用雲Message QueueTT 版的軌跡查詢功能排查裝置線上問題和訊息收發問題。當裝置的狀態出現異常時,您可以使用裝置軌跡查詢功能,查詢裝置的串連歷史;當訊息的收發不符合預期時,您可以使用訊息軌跡查詢功能,查詢訊息的收發軌跡。

查詢裝置軌跡

  1. 登入雲Message QueueTT 版控制台,在頂部功能表列選擇地區(Region),例如華東1(杭州)
  2. 在左側導覽列,單擊軌跡查詢
  3. 軌跡查詢頁面,單擊目標執行個體,單擊裝置軌跡頁簽。
  4. 單擊Client ID文字框。選擇或直接輸入您的Client ID(Client ID的拼接格式為<groupid>@@@<deviceid>),在日期選取器設定時間範圍,單擊搜尋
    說明 時間範圍的最大跨度為1天。
    client_track
    欄位說明
    時間動作發生的日期時間。
    串連ID串連標識。
    動作
    • connect:用戶端請求與服務端串連。
    • close:TCP串連斷開。
    • disconnect:用戶端請求斷開與服務端的串連。
    說明
    • accepted:服務端接收用戶端發起的串連請求。
    • not authorized:用戶端訪問的執行個體許可權校正失敗導致TCP串連斷開。
    • clientId conflict:用戶端標識衝突導致TCP串連斷開。
    • topic auth failed:用戶端訪問的Topic資源許可權校正失敗導致TCP串連斷開。
    • no heart:無心跳導致TCP串連斷開。
    • closed by client:用戶端異常導致TCP串連斷開。
      說明 用戶端沒有發送disconnect報文。
    • disconnected by client:用戶端請求中斷連線。

查詢訊息軌跡

  1. 登入雲Message QueueTT 版控制台,在頂部功能表列選擇地區,例如華東1(杭州)
  2. 在左側導覽列,單擊軌跡查詢
  3. 軌跡查詢頁面,單擊目標執行個體,單擊訊息軌跡頁簽。
  4. 查詢訊息軌跡支援以下三種方式:
    • 組合查詢

      根據Client ID、Message ID和時間範圍,查詢某條訊息的發送軌跡和投遞軌跡。

      單擊組合查詢,單擊Client ID文字框,選擇或輸入您的Client ID(Client ID的拼接格式為<groupid>@@@<deviceid>),單擊Message ID文字框,選擇或輸入要查詢的Message ID,在時間選取器設定時間範圍,單擊搜尋
      說明 時間範圍的最大跨度為1天。
      msgtrack
    • 按Client ID查詢

      根據Client ID和時間範圍,查詢某個用戶端的訊息列表。

      單擊按Client ID查詢,單擊Client ID 文字框,選擇或輸入您的Client ID(Client ID的拼接格式為 <groupid>@@@<deviceid>),在時間選取器設定時間範圍,單擊搜尋
      說明 時間範圍的最大跨度為1天。
      result
    • 按Message ID查詢

      根據Message ID和時間範圍,查詢Message ID相同的訊息的發送軌跡和投遞軌跡。

      單擊按Message ID查詢,單擊Message ID文字框,選擇或輸入要查詢的Message ID,在時間選取器設定時間範圍,單擊搜尋
      說明 時間範圍的最大跨度為1天。
      msgid_result
      欄位說明
      時間訊息發送或投遞的日期時間。
      Client IDs訊息發送或投遞的用戶端的ID。
      說明
      • MQTT用戶端發送:MQTT用戶端發送訊息。
      • 推送至MQTT用戶端:訊息投遞至MQTT用戶端。
      • MQ用戶端發送雲訊息佇列 RocketMQ 版用戶端發送訊息。
      • 推送離線訊息至MQTT用戶端:離線訊息投遞至MQTT用戶端。