集成华为APM SDK无上报数据 设备端APM日志如何查找开启

前置配置开启（需提前配置才能抓取到有效APM日志） #

• 在应用的AndroidManifest.xml的<application>标签下添加APM调试开关：

  <meta-data
      android:name="com.huawei.hms.apm.DEBUG"
      android:value="true" />
  

• 在应用初始化阶段（推荐放在Application的onCreate方法最开头）开启AGC SDK通用调试日志：

  // Java 写法
  AGConnectServicesConfig config = AGConnectServicesConfig.getInstance(context);
  config.setString("log_level", "DEBUG");
  
  // Kotlin 写法
  val config = AGConnectServicesConfig.getInstance(context)
  config.setString("log_level", "DEBUG")
  

• 确认未遗漏APM.getInstance().start()初始化调用，也没有主动调用接口关闭APM数据上报功能。

Logcat日志过滤与存储方法 #

• 日志筛选规则：直接在Logcat控制台输入关键词APM_即可筛选出所有APM相关日志，上报异常、鉴权失败、数据组装失败等关键问题都会以Error级别输出，也可以组合Error级别+APM_关键词快速定位异常。
• 日志存储方法：Android系统Logcat日志默认不会持久化存储到本地，可通过两种方式导出日志：
  • 执行adb命令导出：运行adb logcat -s APM_* > apm_logcat.txt，操作应用复现无上报场景后按Ctrl+C停止抓取，日志会保存到当前命令执行目录下的apm_logcat.txt文件中
  • Android Studio可视化导出：在Logcat面板筛选出APM日志后，右键选择「Export Selected Items to File」即可导出过滤后的日志文件

常见无上报日志排查点 #

• 若日志出现鉴权失败报错：检查agconnect-services.json文件是否正确替换，应用包名、AppId、签名信息是否和AGC后台配置完全一致
• 若日志出现网络请求失败报错：检查设备网络是否可正常访问华为服务，确认HMS Core版本符合APM SDK最低版本要求，且已开启HMS Core联网权限
• 若日志出现无有效上报数据报错：检查是否触发了APM采集规则，冷启动、网络请求、ANR、崩溃等对应场景未触发时不会产生上报数据
• 确认AGC后台选择的应用版本、时间范围和测试版本、测试时间匹配，上报数据最长有5分钟延迟，建议测试后等待10分钟再查看后台数据

内容的提问来源于stack exchange，提问作者DevWithZachary