全部产品

日志拉取

更新时间:2020-12-08 09:37:16

mPaaS 的客户端 SDK 为用户提供写入诊断日志的接口。该诊断日志是指您根据开发需求或排查问题的需要,调用埋点接口写入的日志。此类日志默认只会记录在磁盘中,并不上传。

需要排查问题时,您可以通过日志提取功能下发诊断任务到客户端,客户端收到任务后上传日志到服务器,您便可以在应用分析控制台上下载上传的日志。

客户端诊断日志埋点接口

iOS 埋点

有关 iOS 埋点接口,参见 iOS 客户端诊断

Android 埋点

有关 Android 埋点接口,参见 Android 客户端诊断

下载服务端日志

按以下步骤下载服务端日志:

  1. 登录控制台,进入 产品与服务 > 移动开发平台 > 移动分析 > 日志管理 > 拉取实时日志,点击 添加 按钮进入新增诊断任务页面,然后根据页面提示填写诊断任务内容。

    在配置 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 卡上的文件,都应该只拉取应用自身目录下的文件。

  2. 填写完诊断任务信息后,点击 确定 按钮生成一条诊断任务。

  3. 在诊断任务列表中,选择刚创建的任务,并选择 触发通道,可以是 通过数据同步触发(Sync)通过消息推送(Push),然后点击 触发 按钮触发诊断任务的下发。任务下发成功后,页面上的任务状态会更新。
    触发通道需要与客户端接入诊断的方式保持一致,即如果客户端使用的诊断方式为 数据同步,则触发通道必须选择 通过数据同步触发(Sync);如果诊断方式为 消息推送,则触发通道必须选择 通过消息推送(Push)

  4. 客户端收到诊断任务后,将日志上传到服务器,同时任务状态更新为 处理完成。此时,您可以点击 查看 按钮进入子任务查看页面,点击 下载 按钮下载日志。

    下载