全部產品
Search
文件中心

Mobile Platform as a Service:拉取即時日誌

更新時間:Jul 13, 2024

mPaaS 的用戶端 SDK 為使用者提供寫入診斷記錄的介面。該診斷記錄是指您根據開發需求或排查問題的需要,調用埋點介面寫入的日誌。此類日誌預設只會記錄在磁碟中,並不上傳。

需要排查問題時,您可以通過日誌提取功能下發診斷任務到用戶端,用戶端收到任務後上傳日誌到伺服器,您便可以在應用分析控制台上下載上傳的日誌。

前置條件

拉取即時日誌前,確保已完成用戶端診斷記錄埋點。有關日誌埋點操作,請參見 iOS 用戶端診斷Android 用戶端診斷

下載服務端日誌

下載服務端日誌的操作如下:

  1. 登入 mPaaS 控制台,從左側導覽列進入 移動分析 > 日誌管理 > 拉取即時日誌 頁面。

  2. 單擊 添加 按鈕進入新增診斷任務頁面,然後根據頁面提示填寫診斷任務內容。

    在配置 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 記憶卡上的檔案,都應該只拉取應用自身目錄下的檔案。

  3. 填寫完診斷任務資訊後,點擊 確定 按鈕產生一條診斷任務。

  4. 在診斷工作清單中,選擇剛建立的任務,並選擇 觸發通道,然後點擊 觸發 按鈕觸發診斷任務的下發。任務下發成功後,頁面上的任務狀態會更新。

    觸發通道需要與用戶端接入診斷的方式保持一致,即如果用戶端使用的診斷方式為 資料同步,則觸發通道必須選擇 通過資料同步觸發(Sync);如果診斷方式為 訊息推送,則觸發通道必須選擇 通過訊息推送(Push)

  5. 用戶端收到診斷任務後,將日誌上傳到伺服器,同時任務狀態更新為 處理完成。此時,您可以點擊 查看 按鈕進入子任務查看頁面,點擊 下載 按鈕下載日誌。