Simple Message Queue (formerly MNS)：日誌管理

應用情境

您在收發訊息的過程中，是否遇到過以下問題：

• 訊息成功發送到隊列，但消費端收不到訊息，訊息去哪兒了？

• 訊息被誰消費了？消費了幾次？

• 消費端宕機了，消費失敗的訊息什麼時候可以再次被消費？

• 訊息發布到主題，Endpoint卻遲遲收不到訊息？

這些問題可以通過輕量訊息佇列（原 MNS）的日誌管理功能解決，方法如下：

• 將日誌推送到SLS，在控制台查看完整訊息軌跡。

• 使用官網提供查詢工具，指定相應參數即可查看訊息的處理日誌。

費用說明

• 輕量訊息佇列（原 MNS）不針對日誌管理功能收取額外費用。

• 輕量訊息佇列（原 MNS）將日誌推送到SLS，對應服務會根據儲存空間、流量、請求數等進行收費，詳情請參見計費概述。

隊列日誌格式說明

隊列訊息作業日誌是指操作隊列訊息所產生的日誌，例如發送訊息、消費訊息、刪除訊息等操作。一條訊息作業日誌中包含多個欄位，每個欄位都有特定的含義。根據操作的不同，訊息作業日誌所包含的欄位也不相同。以下分別介紹各個欄位的含義和不同操作所包含的欄位資訊。

• 日誌欄位解析

  一條訊息作業日誌中包含多個欄位，各個欄位的含義如下：

  欄位	含義
  Time	本次操作的發生時間。
  MessageId	訊息的MessageId，標識本次操作處理的訊息。
  QueueName	本次操作對應的隊列名稱。
  AccountId	本次操作對應隊列的帳號。
  RemoteAddress	發起該操作的用戶端地址。
  NextVisibleTime	該操作執行完成後，這條訊息的下次可見時間。
  ReceiptHandleInRequest	用戶端執行該操作時傳入的ReceiptHandle參數。
  ReceiptHandleInResponse	該操作執行完成後，返回用戶端的ReceiptHandle。
  ProcessTime	本次操作的處理時間。
  RequestId	本次執行的任務ID。
  Action	表示動作，例如：刪除、發送等。

• 各個操作的欄位列表

  不同操作的日誌包含的欄位資訊各不相同，具體每個操作包含的欄位如下：

  操作	Time	QueueName	AccountId	MessageId	RemoteAddress	NextVisibleTime	ReceiptHandleInResponse	ReceiptHandleInRequest
  SendMessage/BatchSendMessage	有	有	有	有	有	有	無	無
  PeekMessage/BatchPeekMessage	有	有	有	有	有	無	無	無
  ReceiveMessage/BatchReceiveMessage	有	有	有	有	有	有	有	無
  ChangeMessageVisibility	有	有	有	有	有	有	有	有
  DeleteMessage/BatchDeleteMessage	有	有	有	有	有	有	無	有

主題日誌格式說明

主題訊息作業日誌是指操作主題訊息產生的日誌，主要有兩類：發布訊息和推送訊息。以下分別介紹主題訊息作業日誌各個欄位的含義，以及不同的操作所包含的欄位資訊。

• 日誌欄位解析

  一條訊息作業日誌中包含多個欄位，各個欄位的含義如下：

  欄位	含義
  Time	本次操作的發生時間。
  MessageId	訊息的MessageId，標識本次操作處理的訊息。
  TopicName	本次操作對應的主題名稱。
  SubscriptionName	本次操作對應的訂閱名稱。
  AccountId	本次操作對應主題的帳號。
  RemoteAddress	發起該操作的用戶端地址。
  NotifyStatus	輕量訊息佇列（原 MNS）將訊息推送給使用者時，使用者返回的狀態代碼或者相應的出錯資訊。
  ProcessTime	本次操作的處理時間。
  MessageTag	設定的訊息標籤。
  RequestId	本次執行的任務ID。
  Action	表示動作，例如：刪除、發送等。

• 各個操作的欄位列表

  不同操作的日誌包含的欄位資訊各不相同，具體每個操作包含的欄位如下：

  操作	Time	MessageId	TopicName	SubscriptionName	AccountId	RemoteAddress	NotifyStatus	SubscriptionName
  PublishMessage	有	有	有	無	有	有	無	無
  Notify	有	有	有	有	有	無	有	有

• NotifyStatus

  NotifyStatus是推送訊息日誌特有的欄位，可以協助您排查輕量訊息佇列（原 MNS）推送訊息到Endpoint失敗的原因。 根據不同的NotifyStatus，您可以按照下表建議的處理方法進行處理。

  錯誤碼	描述	建議處理方法
  2xx	訊息推送成功。	無。
  其它HTTP狀態代碼	訊息推送給使用者，Endpoint返回了非2xx的狀態代碼。	檢查Endpoint端處理邏輯。
  InvalidHost	訂閱指定的Endpoint不合法。	確認訂閱中Endpoint是否真實有效，可使用curl或telnet進行確認。
  ConnectTimeout	串連訂閱指定的Endpoint逾時。	確認訂閱中Endpoint當前是否可訪問，可使用curl或telnet進行確認。
  ConnectFailure	串連訂閱指定的Endpoint失敗。	確認訂閱中Endpoint當前是否可訪問，可使用curl或telnet進行確認。
  UnknownError	未知錯誤。	請聯絡輕量訊息佇列（原 MNS）技術人員支援。

日誌管理操作

如需使用日誌功能，請先完成以下操作：

查看日誌