421      阿裏雲

日誌服務__產品管理_控製台使用手冊_阿裏雲物聯網套件-阿裏雲

日誌服務會將設備與物聯網套件交互過程中全鏈路日誌信息記錄到用戶的日誌庫中，用戶可以通過查詢日誌快速定位設備和配置問題，提升debug能力。

備注:日誌庫由阿裏雲“日誌服務”產品提供，需要用戶自己開通和購買該產品。

配置日誌服務

選擇需要記錄日誌的產品，進入產品管理頁麵下的日誌服務頁麵，點擊配置日誌服務。

如果之前沒有日誌庫的資源，請點擊創建Project進入日誌服務控製台進行創建project。日誌庫創建完成以後，請刷新頁麵，獲取最新的日誌庫信息。同理，沒有logstore資源，也需要去日誌服務控製台進行創建logstore。

創建完日誌庫資源，用戶還需要創建一個具有日誌服務寫入權限的角色，因為物聯網套件不能操作用戶的日誌庫，必須經過用戶的授權才能對用戶的日誌庫進行寫日誌。這樣套件隻有被賦予這個角色才能將全鏈路日誌寫入日誌庫中。

有日誌庫資源之後，根據自己的業務選擇需要配置的日誌庫，包括：地域、Project、logstore、角色，點擊“保存”，完成配置。

如果不再需要記錄日誌，請點擊取消配置,一旦取消配置，套件將不會把產品相關所有日誌寫進日誌庫中。

查詢日誌

點擊查詢日誌，進入日誌庫，如果沒有配置日誌索引，此時還無法預覽日誌，需要配置日誌索引，請點擊開啟索引。

如果隻是簡單預覽全日誌信息，請在分詞符中輸入nt, ;"'(){}[]<>?/#:=&，點擊確認進行保存。

索引設置完成以後，請點擊搜索，係統默認顯示最近15分鍾獲取的日誌。

注意：日誌服務需要1分鍾左右的時間來建全文索引，因此此處查詢日誌會有1分鍾左右的時延。如果想確認日誌是否產生，請點擊返回日誌庫列表，點擊預覽進行查看。

日誌格式說明

整體的日誌格式

日誌示例：

具體說明

1. 時間戳：由於日誌服務顯示時存在亂序問題，查看日誌時以該時間戳為準。

2. deviceId/productKey：產生該日誌的設備Id或產品Key。

3. 動作:

   動作	動作說明
   PUBLISH	往物聯網套件發送消息
   SUBSCRIBE	從物聯網套件訂閱消息
   RULE-MATCH	執行規則引擎匹配
   RULE-ACTION	規則引擎動作執行
   DEVICE-AUTH	執行設備認證
   DEVICE-STATE	設備狀態改變

4. 狀態：

   狀態值	狀態說明
   START	處理開始
   END	處理結束
   SUCCESS	處理成功
   FAILURE	處理失敗

5. 內容：

   內容	動作	說明
   Published message to topic:$TOPIC	PUBLISH	開始發布消息給某個topic
   No authorization to publish message to topic:$TOPIC	PUBLISH	沒有往某個Topic發布消息的權限
   Subscriber:$SUBER started to receive the message from the topic:$TOPIC	PUBLISH	開始將Topic的消息發送給所有訂閱者
   Subscriber:$SUBER failed to receive the message from the topic:$TOPIC. Reason:Device Offline	PUBLISH	Topic的消息發送給某個訂閱者失敗，失敗原因是設備離線
   Started to subscribe on the topic:$TOPIC	SUBSCRIBE	請求訂閱topic，成為該topic的訂閱者
   No authorization to subscribe on topic:$TOPIC	SUBSCRIBE	沒有權限去訂閱Topic消息
   Successfully subscribed on the topic:$TOPIC	SUBSCRIBE	訂閱Topic成功
   Device Online.	DEVICE-STATE	設備上線
   Device Offline.	DEVICE-STATE	設備下線
   Topic:$TOPIC matched $NUMBER rules {$RULE}	RULE-MATCH	Topic匹配了$NUMBER條規則，並顯示具體的規則內容
   Payload is not a JSON string!	RULE-MATCH	匹配規則時發生錯誤，原因為publish的內容不是JSON串
   Rule executed {Index:$NUMBER,Name:$RULE}	RULE-MATCH	執行匹配到的第$NUMBER條規則$RULE
   Rule executed {Index:$NUMBER,Name:$RULE},Failed:$FAILED	RULE-MATCH	執行匹配到的第$NUMBER條規則$RULE失敗，原因為$FAILED
   Type:DataHub, Name:$NAME	RULE-ACTION	將數據轉發到DataHub的Topic（$NAME）中
   Type:DataHub, Name:$NAME, Failed:$FAILED	RULE-ACTION	將數據轉發到DataHub的Topic（$NAME）中失敗，原因為$FAILED
   Type:MNS, Name:$NAME	RULE-ACTION	將數據轉發到MNS的主題（$NAME）中
   Type:MNS, Name:$NAME, Failed:$FAILED	RULE-ACTION	將數據轉發到MNS的主題（$NAME）中失敗，原因為$FAILED
   Type:Table Store, Name:$NAME	RULE-ACTION	將數據轉發到表格存儲的實例（$NAME）中
   Type:Table Store, Name:$NAME, Failed:$FAILED	RULE-ACTION	將數據轉發到表格存儲的實例（$NAME）中失敗，原因為$FAILED
   Type:RDS, Name:$NAME	RULE-ACTION	將數據轉發到RDS的Table（$NAME）中
   Type:RDS, Name:$NAME, Failed:$FAILED	RULE-ACTION	將數據轉發到RDS的Table（$NAME）中失敗，原因為$FAILED
   Type:REPUBLISH, Name:$NAME	RULE-ACTION	將數據重新轉發到另一個Topic($NAME)
   Type:REPUBLISH, Name:$NAME, Failed:$FAILED	RULE-ACTION	將數據重新轉發到另一個Topic($NAME)，失敗，原因為$FAILED

$表示可變內容

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

  上一篇： 服務配置__產品管理_控製台使用手冊_阿裏雲物聯網套件-阿裏雲

  下一篇： 處理數據__規則引擎_控製台使用手冊_阿裏雲物聯網套件-阿裏雲