應用場景

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

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

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

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

• 消息發布到主題，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）技術人員支持。

日志管理操作

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

開啟日志功能

推送日志到日志服務

查看日志