全部产品
云市场

Android 客户端诊断

更新时间:2020-07-10 11:56:54

重要:自 2020 年 6 月 28 日起,mPaaS 停止维护 10.1.32 基线。请使用 10.1.6810.1.60 系列基线。可以参考 mPaaS 10.1.68 升级指南mPaaS 10.1.60 升级指南 进行基线版本升级。

为了能对用户日志进行分析,排查线上问题,可以在 App 需要的关键链路调用埋点日志接口,添加日志信息,后续可以以文件的形式展示,方便进行问题排查。

前置条件

客户端打印日志

使用 mPaaS 的日志工具代替 Logcat 的标准方法 Log 来打印日志。

  • 10.1.32 版本及以上:
    1. MPLogger.info(String tag, String msg);
  • 更多日志级别:
    1. void verbose(String tag, String msg);
    2. void debug(String tag, String msg);
    3. void info(String tag, String msg);
    4. void warn(String tag, String msg);
    5. void warn(String tag, Throwable t);
    6. void error(String tag, String msg);
    7. void error(String tag, Throwable t);

在控制台拉取日志

您可以在控制台拉取使用 mPaaS 的日志工具打印的日志,从而快速便捷地分析 App 在指定机型或用户上出现的崩溃或异常问题。

操作步骤

1. 创建日志拉取任务

  1. 进入 mPaaS 控制台,选择应用。
  2. 在左侧导航栏中,点击 移动分析 > 日志管理
  3. 拉取实时日志 标签页中,点击 添加 按钮。
  4. 填写任务信息,其中:
    • 用户 ID:您的应用登录系统中用户的标识。一般在报活日志中通过 MPLogger.setUserId(userId)LoggerFactory.getLogContext().setUserId(userId) 设置。详情参见 报活日志
  5. 点击 确认 按钮,完成日志拉取任务创建。

2. 触发日志拉取任务

  1. 在日志拉取任务列表中,找到刚刚创建的任务。点击操作列的 触发 Push/Sync
  2. 稍等片刻刷新页面,若任务状态为:
    • 任务处理完成:点击 查看 按钮即可下载诊断日志。
    • 调用 Push 服务成功:表示已下发上传诊断日志的消息,但客户端还未收到,原因可能是:
      • 用户设备未开机、无网络或用户禁止应用自启动,从而导致 Push 服务无法唤醒。
      • 集成推送组件错误,未初始化推送,或启动后未通过 Push 绑定 userId 。
      • 集成埋点组件错误,未配置 ClientMonitorServiceClientMonitorWakeupReceiver