mPaaS 的用戶端 SDK 為使用者提供寫入診斷記錄的介面。該診斷記錄是指您根據開發需求或排查問題的需要,調用埋點介面寫入的日誌。此類日誌預設只會記錄在磁碟中,並不上傳。
需要排查問題時,您可以通過日誌提取功能下發診斷任務到用戶端,用戶端收到任務後上傳日誌到伺服器,您便可以在應用分析控制台上下載上傳的日誌。
前置條件
拉取即時日誌前,確保已完成用戶端診斷記錄埋點。有關日誌埋點操作,請參見 iOS 用戶端診斷 和 Android 用戶端診斷。
下載服務端日誌
下載服務端日誌的操作如下:
登入 mPaaS 控制台,從左側導覽列進入 移動分析 > 日誌管理 > 拉取即時日誌 頁面。
單擊 添加 按鈕進入新增診斷任務頁面,然後根據頁面提示填寫診斷任務內容。
在配置 Android 平台的診斷任務時,如果日誌類型選擇 自訂拉取路徑,則在填寫自訂路徑時需注意以下兩點:
需確保自訂路徑為單個檔案,而非目錄。若為手機 SD 記憶卡下的檔案,則路徑前須加上
/storage/emulated/0/
,例如/storage/emulated/0/Android/data/com.mpaas.aar.demo.analytics/files/mdap/upload/log.txt
。檔案路徑必須包含應用程式套件名,例如
com.mpaas.aar.demo.analytics
,考慮到應用行為規範,該包名必須與您在 代碼配置 中填寫的 Package Name 保持一致。無論是應用內部儲存的檔案還是 SD 記憶卡上的檔案,都應該只拉取應用自身目錄下的檔案。
填寫完診斷任務資訊後,點擊 確定 按鈕產生一條診斷任務。
在診斷工作清單中,選擇剛建立的任務,並選擇 觸發通道,然後點擊 觸發 按鈕觸發診斷任務的下發。任務下發成功後,頁面上的任務狀態會更新。
觸發通道需要與用戶端接入診斷的方式保持一致,即如果用戶端使用的診斷方式為 資料同步,則觸發通道必須選擇 通過資料同步觸發(Sync);如果診斷方式為 訊息推送,則觸發通道必須選擇 通過訊息推送(Push)。
用戶端收到診斷任務後,將日誌上傳到伺服器,同時任務狀態更新為 處理完成。此時,您可以點擊 查看 按鈕進入子任務查看頁面,點擊 下載 按鈕下載日誌。