978      阿裏雲

消息查詢__控製台使用指南_消息隊列 MQ-阿裏雲

MQ 控製台提供幾種消息查詢方式用於問題排查。

適用場景

MQ 提供了三種消息查詢的方式，分別是根據 Messag ID，Message Key 以及 Topic 查詢。三種方式的特點和對比如下。

建議查詢過程：

根據 Message ID 查詢

根據 Message ID 查詢消息屬於精確查詢，用戶輸入 Message ID 信息即可精確查詢到任意一條消息。因此，為了盡可能精確地查詢，建議發送方調用 Producer 發送消息時，在發送消息成功後將 Message ID 信息打印到日誌中，方便問題排查。

以 Java SDK 為例，獲取 Message ID 的方法如下：

     SendResult sendResult = producer.send(msg);
     String msgId = sendResult.getMessageId();

查詢結果說明

查詢到消息後，您可以在消息詳情頁麵看到每條消息的基本屬性，消息體下載鏈接以及消息的消費狀態，如下圖所示：

其中，投遞狀態是 MQ 根據各個 Consumer ID 的消費進度計算出的結果，投遞狀態的信息參考以下表格。

注意：投遞狀態僅僅是根據消費進度估算的結果，如果需要詳細的消費信息，請使用消息軌跡工具查詢。消息軌跡可以展示該條消息的完整鏈路，具體請參見查詢消息軌跡。

投遞狀態表

消費驗證

MQ提供了消費驗證功能，該功能可以將指定消息推送給指定的在線客戶端，以檢測客戶端消費該消息的邏輯和結果是否符合預期。

注意：消費驗證功能僅僅是用於驗證客戶端的消費邏輯是否正常，並不會影響正常的收消息流程，因此消息的消費狀態等信息在點擊消費驗證後並不會改變。

根據 Message Key 查詢

Message Key 查詢消息的原理是，MQ 根據用戶設置的 Message Key 信息建立消息的索引信息，當用戶輸入 Key 進行查詢時，根據該索引即可匹配相關的消息返回。

注意：

1. Message Key 查詢條件是用戶設置的 Message Key 屬性。
2. Message Key 查詢僅僅返回符合條件的最近的 64 條消息，因此建議業務方設置 Key 時盡可能唯一，並具有業務區分度。

設置 Message Key 的方法：

        Message msg = new Message("Topic","*","Hello MQ".getBytes());
        /**
         * 對每條消息設置其檢索的Key，該Key值設置代表消息的業務關鍵屬性，請盡可能全局唯一。
         * 以方便您在無法正常收到消息情況下，可通過MQ控製台查詢消息。不設置也不會影響消息正常收發
         */
        msg.setKey("TestKey"+System.currentTimeMillis());

查詢樣例如下圖所示：

根據 Topic 查詢

根據 Topic 查詢一般用在前兩種查詢條件都無法獲得的情況下，根據 Topic 和消息的發送時間範圍，批量獲取該時間範圍內的所有消息，然後再找到關心的數據。

注意：

1. Topic 查詢屬於範圍查詢，獲取 Topic 下符合時間條件的所有消息，消息量大，建議盡量縮短查詢區間。
2. Topic 查詢數據量大，采用分頁展示。

查詢樣例如下圖所示：

最後更新：2016-11-23 16:04:04

  上一篇： 發布訂閱管理__控製台使用指南_消息隊列 MQ-阿裏雲

  下一篇： MQTT 管理__控製台使用指南_消息隊列 MQ-阿裏雲