文档中心

应用性能监控全链路版

最佳实践

使用崩溃分析

使用崩溃分析

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

步骤一：获取SDK

在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/"
}
}
}

接入客户端监控。

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

classpath "com.volcengine:apm_insight_plugin:1.4.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.10'

海外应用接入oversea版本，上报到马来西亚柔佛，使用如下依赖：

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

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

在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？。

启动崩溃监控，开始收集数据。

注意

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

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

步骤三：验证数据上报

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

添加以下代码，等待App发生Java崩溃。

throw new RuntimeException("Monitor Exception"); // 执行就崩，如果应用启动后8秒内崩溃，则判定为启动崩溃进行上报

重新启动App，SDK会立即上报上次启动期间发生的崩溃，然后在控制台查看上报成功的日志。

步骤四：新建报警任务

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

登录客户端监控控制台。

单击目标应用下的App端监控。

在控制台左上角选择全部功能 > 崩溃报警。

在崩溃报警任务页面，单击新建报警任务。

在新建报警任务页面，按照以下示例完成配置，然后单击保存。

报警基本信息

制定报警策略

配置通知受众

步骤五：查看报警详情

如果控制台在登陆状态，当飞书群收到报警通知时，可以直接单击消息卡片中的详细信息进入崩溃报警页面。

如果控制台非登陆状态，收到报警通知时，请登陆后按照以下操作查看报警详情。

在控制台左上角选择全部功能 > 崩溃报警。

在崩溃报警任务页面，找到任务名称crash日环比，在其右侧操作列单击报警详情。

在崩溃报警页面，在报警情况概览中查看报警分布，报警列表中查看详细的报警报警内容等信息，帮助分析崩溃问题。

最近更新时间：2026.10.15 20:24:46

这个页面对您有帮助吗？

有用

有用

无用

无用