本文介紹如何使用雲Message QueueTT 版的軌跡查詢功能排查裝置線上問題和訊息收發問題。當裝置的狀態出現異常時,您可以使用裝置軌跡查詢功能,查詢裝置的串連歷史;當訊息的收發不符合預期時,您可以使用訊息軌跡查詢功能,查詢訊息的收發軌跡。
查詢裝置軌跡
- 登入雲Message QueueTT 版控制台,在頂部功能表列選擇地區(Region),例如華東1(杭州)。
- 在左側導覽列,單擊軌跡查詢。
- 在軌跡查詢頁面,單擊目標執行個體,單擊裝置軌跡頁簽。
- 單擊Client ID文字框。選擇或直接輸入您的Client ID(Client ID的拼接格式為<groupid>@@@<deviceid>),在日期選取器設定時間範圍,單擊搜尋。說明 時間範圍的最大跨度為1天。

欄位 說明 時間 動作發生的日期時間。 串連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:用戶端請求中斷連線。
查詢訊息軌跡
- 登入雲Message QueueTT 版控制台,在頂部功能表列選擇地區,例如華東1(杭州)。
- 在左側導覽列,單擊軌跡查詢。
- 在軌跡查詢頁面,單擊目標執行個體,單擊訊息軌跡頁簽。
- 查詢訊息軌跡支援以下三種方式:
- 組合查詢
根據Client ID、Message ID和時間範圍,查詢某條訊息的發送軌跡和投遞軌跡。
單擊組合查詢,單擊Client ID文字框,選擇或輸入您的Client ID(Client ID的拼接格式為<groupid>@@@<deviceid>),單擊Message ID文字框,選擇或輸入要查詢的Message ID,在時間選取器設定時間範圍,單擊搜尋。說明 時間範圍的最大跨度為1天。
- 按Client ID查詢
根據Client ID和時間範圍,查詢某個用戶端的訊息列表。
單擊按Client ID查詢,單擊Client ID 文字框,選擇或輸入您的Client ID(Client ID的拼接格式為 <groupid>@@@<deviceid>),在時間選取器設定時間範圍,單擊搜尋。說明 時間範圍的最大跨度為1天。
- 按Message ID查詢
根據Message ID和時間範圍,查詢Message ID相同的訊息的發送軌跡和投遞軌跡。
單擊按Message ID查詢,單擊Message ID文字框,選擇或輸入要查詢的Message ID,在時間選取器設定時間範圍,單擊搜尋。說明 時間範圍的最大跨度為1天。
欄位 說明 時間 訊息發送或投遞的日期時間。 Client IDs 訊息發送或投遞的用戶端的ID。 說明 - MQTT用戶端發送:MQTT用戶端發送訊息。
- 推送至MQTT用戶端:訊息投遞至MQTT用戶端。
- MQ用戶端發送:雲訊息佇列 RocketMQ 版用戶端發送訊息。
- 推送離線訊息至MQTT用戶端:離線訊息投遞至MQTT用戶端。
- 組合查詢