You need to enable JavaScript to run this app.
导航
使用崩溃分析
最近更新时间:2024.11.13 17:42:42首次发布时间:2024.09.04 20:52:16

本文介绍当Android App需要接入App监控,并持续关注崩溃日环比的增长情况时,业务需要操作的完整流程。

步骤一:获取SDK

  1. 在project级别的build.gradle文件中,添加maven地址。

    buildscript {
        repositories {
            maven {
                url "https://artifact.bytedance.com/repository/Volcengine/"
            }
            maven {
                url "https://artifact.bytedance.com/repository/byteX/"
            }
        }
    }
    allprojects {
        repositories {
            maven {
                url "https://artifact.bytedance.com/repository/Volcengine/"
            }
        }
    }
    
  2. 接入应用性能监控全链路版。

    1. 在project级别的build.gradle文件的dependencies中,添加以下代码,接入插件组件辅助插桩。apm_insight_plugin 国内海外使用同一个版本。

      classpath "com.volcengine:apm_insight_plugin:1.4.2"
      
    2. 在app module的build.gradle文件的dependencies中,添加以下代码,根据国内应用还是海外应用选择下面两个版本的一个。

      • 国内应用接入cn版本,上报到中国,使用如下依赖:

        // 国内应用在dependencies中添加
        implementation 'com.volcengine:apm_insight:1.5.6.cn'
        implementation 'com.volcengine:apm_insight_crash:1.5.9'
        
      • 海外应用接入oversea版本,上报到马来西亚柔佛,使用如下依赖:

        // 海外应用在dependencies中添加
        implementation 'com.volcengine:apm_insight:1.5.7.oversea'
        implementation 'com.volcengine:apm_insight_crash:1.5.8.oversea'
        

步骤二:初始化SDK并开启监控

  1. 在Application中onCreate中,添加以下代码,初始化崩溃相关功能。

    MonitorCrash.Config config = MonitorCrash.Config.app({{AppId}})
                    .token({{AppToken}})// 设置鉴权token,可从平台应用信息处获取,token错误无法上报数据
                  .build();
            MonitorCrash monitorCrash = MonitorCrash.init(ApplicationContext, config);
    

    说明

    • Context建议传递ApplicationContext。
    • 参数都不能为null,否则初始化会失败。
    • 初始化返回的MonitorCrash实例为后续配置的入口。
    • 避免重复调用初始化方法,并对init返回对象做空指针判断。
    • aid可以在平台项目浏览器的URL上面获取。
    • AppID和AppToken获取方法,请参见如何查询AppID和AppToken?
  2. 启动崩溃监控,开始收集数据。

    注意

    请在用户同意隐私政策后,再调用方法收集数据。

    // 启动监控,当初始化时autoStart传入false设置为初始化时不自动开启监控,需要在合适的位置调用start方法开启监控;如果初始化时未设置autoStart参数或者设置为true,将自动开启监控,不需要调用start方法。
            if (monitorCrash != null) {
                monitorCrash.start();
            }
    

步骤三:验证数据上报

崩溃是100%上报的,不受采样率控制。您可以执行以下操作,验证数据上报。

  1. 添加以下代码,等待App发生Java崩溃。

    throw new RuntimeException("Monitor Exception"); // 执行就崩,如果应用启动后8秒内崩溃, 则判定为启动崩溃进行上报
    
  2. 重新启动App,SDK会立即上报上次启动期间发生的崩溃,然后在控制台查看上报成功的日志。

步骤四:新建报警任务

您可以新建崩溃报警任务,设置合适的报警策略,帮助您持续关注崩溃日环比的增长情况。

  1. 登录应用性能监控全链路版控制台
  2. 单击目标应用下的App端监控
  3. 在控制台左上角选择全部功能 > 崩溃报警
  4. 崩溃报警任务页面,单击新建报警任务
  5. 新建报警任务页面,按照以下示例完成配置,然后单击保存
    • 报警基本信息
      Image
    • 制定报警策略
      Image
    • 配置通知受众
      Image

步骤五:查看报警详情

如果控制台在登陆状态,当飞书群收到报警通知时,可以直接单击消息卡片中的详细信息进入崩溃报警页面。
如果控制台非登陆状态,收到报警通知时,请登陆后按照以下操作查看报警详情。

  1. 在控制台左上角选择全部功能 > 崩溃报警
  2. 崩溃报警任务页面,找到任务名称crash日环比,在其右侧操作列单击报警详情
    Image
  3. 崩溃报警页面,在报警情况概览中查看报警分布,报警列表中查看详细的报警报警内容等信息,帮助分析崩溃问题。
    Image