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