裝置(包括網關和子裝置)可以上報日誌到雲端。您可以在物聯網平台控制台Log Service頁,查詢裝置本地日誌,進行故障分析。
前提條件
- 裝置已使用Android SDK或C SDK開發完成,並上報日誌。具體操作,請參見裝置日誌上報。
- 如果裝置通過SDK開發實現了日誌上報開關功能,則需要在 的裝置列表,單擊裝置對應的查看按鈕,進入裝置詳情頁,開啟裝置本地日誌上報開關;裝置未實現日誌上報開關功能的,無需開啟開關。
查詢裝置本地日誌
- 登入物聯網平台控制台。
在執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。
- 在左側導覽列,單擊 。
- 選擇產品,選擇裝置本地日誌頁簽。
- 輸入搜尋條件,然後單擊搜尋表徵圖。
支援的搜尋條件如下表。
搜尋條件 說明 DeviceName 輸入裝置名稱。根據裝置名稱,搜尋該裝置的相關日誌。 TraceId 輸入追蹤ID,搜尋串聯模組日誌。 模組名關鍵字 輸入模組名,搜尋該模組產生的日誌。 內容關鍵字 輸入日誌內容關鍵字搜尋日誌。支援的關鍵字:API請求入參、錯誤原因、訊息ID(MessageID)、裝置ID(clientId)、操作(Operation)。 時間範圍 選擇要查詢日誌的上報時間範圍。
日誌欄位說明
日誌中包含的欄位說明如下表。
參數 | 含義 |
上報時間 | 裝置端上報日誌的時間。 |
採集時間 | 裝置端採集日誌的時間。 |
TraceId | 追蹤ID,可用於搜尋串聯模組。 |
DeviceName | 裝置名稱。 |
記錄層級 | 預設顯示所有層級的日誌,您可以僅查詢某一層級的日誌。除OTHER層級外,記錄層級從高到低為:
|
模組名 | 產生日誌的模組名稱。
|
內容 | 日誌內容詳情。 |
裝置日誌分析
日誌內容中包含結果狀態代碼Code。根據結果狀態代碼進行日誌分析。
錯誤碼包含裝置端SDK產生的錯誤碼(Android SDK的錯誤碼和C SDK的錯誤碼)和使用者自訂的狀態代碼。