You need to enable JavaScript to run this app.
导航
验证数据上报
最近更新时间:2023.11.29 16:36:24首次发布时间:2023.11.29 14:12:44

您可以根据业务需求,按照以下模块说明,检查对应模块是否接入成功。

前提条件

完成SDK上报配置

  • 配置设备白名单
    SDK上报配置页面默认配置的采样率较低,在SDK接入测试阶段请配置DID白名单,确保当前设备所有性能数据都采样命中,才能上报到平台查看这些数据。具体请参见创建白名单如何获取DID?
  • 配置各模块采样率
    崩溃是100%上报的,不受采样率控制。除了崩溃,其他监控数据需要在SDK上报配置页面配置采样上报,默认情况下采样命中后才会上报。
    例如,验证卡顿数据前,请在SDK上报配置页面打开总开关,并将卡顿采样率配置为100%。验证完成后,再修改为适合的采样率。具体请参见创建SDK上报配置

Java崩溃/Java启动崩溃

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

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

卡顿分析

  1. 在主线程调用以下函数,等待App发生卡顿。

    private void testSeriousBlock() {
        try {
            Thread.sleep(3500);
        } catch (Exception e){
        }
    }
    

    严重卡顿把sleep时间修改为6000毫秒。

    注意

    示例代码运行一次即可,运行多次可能会发生ANR,此时如果您只接入了性能组件是无法查看ANR日志的,如果您想查看ANR日志需要同时接入崩溃组件。

  2. 初始化SDK时,在主线程阻塞,App会自动监控到卡顿,2分钟内会上报到服务器。

启动分析/页面响应

初始化SDK时,打开启动分析和页面响应的开关,App启动一段时间SDK会自动上报启动分析、页面响应的数据。

流畅性/丢帧

初始化SDK时,打开配置功能的开关,用户进入页面后滑动一段时间SDK会自动上报流畅性数据和丢帧数据。

内存优化

初始化SDK时,打开配置功能开关,设置debug测试模式。

builder.debugMode(true);
builder.memoryMonitor(true);

以上代码可以模拟发生以下两种场景:

  • OOM获取模式
    • 默认在OOM(内存使用100%)的时候进行内存文件分析。
    • 调用模拟OOM的方法OOMMaker.createOOM();
    • 重新启动后,会自动上报内存数据,几分钟后在服务器查看内存数据。
  • 内存触顶模式
    • 如果日活过少,没有OOM或者很少OOM,但是您想分析内存问题,可以在SDK上报配置页面配置启动日志收集的内存占用比例,配置后在内存使用达到阈值时,SDK会上报启动日志收集内存信息,进行内存文件分析。
    • 调用模拟内存增加的方法OOMMaker.createReachTop(80);
      示例中阈值配置为80%,请根据实际业务场景修改阈值。
    • 稍等1分钟等待获取内存文件,然后重新启动后,会自动上报内存数据,几分钟后去服务器查看内存数据。

网络分析

初始化SDK时,配置插桩ApmPlugin的okHttp3Switch,打开网络监控开关。
当App使用okhttp3进行访问时会自动监控到并上报到服务器。插桩支持的okhttp版本最低是3.10.0。当前okhttp3对外暴露了上报网络监控数据的接口。
其他网络库监控需要自己采集网络监控数据,然后再通过网络监控数据接口上报网络数据,才能在平台查看监控数据。具体上报接口和上报数据结构请联系技术支持获取。

上报策略

网络监控日志记录后不会立即上报,每经过60s,触发一次上报。

电量分析

初始化SDK时,打开电量开关。
App启动后,端上采样命中会自动采集上报电量数据。

事件上报

事件管理页面新增事件并配置采样,事件采样命中才会上报。

配置事件上报的规则

HashMap<String, String> dimension = new HashMap<>();
//维度值
dimension.put("key1", "value1");
dimension.put("key2", "value2");
HashMap<String, Double> metric = new HashMap<>();
//指标值
metric.put("metric1", (double) 10);
metric.put("metric2", 8.8);
ApmInsightAgent.monitorEvent("event1", dimension, metric);

配置事件采样

/**
 * 事件上报
 *
 * @param serviceName 事件名
 * @param dimension   可枚举Key-Value,代表维度。key代表维度名称,value代表维度值,平台会自动计算key值下的value的百分占比和上报量
 * @param metric      不可枚举的Key-Value,代表指标。key代表指标名称,value代表指标值,平台会自动计算value的平均值和上报量
 */
public static void monitorEvent(final String serviceName, final Map<String, String> dimension, final Map<String, Double> metric) {
}
/**
 * 事件上报
 *
 * @param serviceName 事件名
 * @param dimension   可枚举Key-Value标识维度
 * @param metric      不可枚举的Key-Value标识指标
 * @param extraJson   辅助分析事件的数据,只可以在单点原始日志查看
 *
 */
public static void monitorEvent(final String serviceName, final Map<String, String> dimension, final Map<String, Double> metric, final JSONObject extraJson) {
}

通过以上事件上报的接口配置事件采样后,可以在平台查看事件信息。
平台查看的事件示例:

//代表event1 采样没有命中
2021-04-11 21:19:01.019 13535-13587/com.example.apm.insight.demo D/ApmInsight: Receive:EventData event1 simple:false
//代表event2 采样命中
2021-04-11 21:19:01.916 13535-13587/com.example.apm.insight.demo D/ApmInsight: Receive:EventData event102 simple:true

上报策略

事件日志记录后不会立即上报,每经过60s,触发一次上报。

CPU监控

初始化SDK时,打开CPU监控,CPU指标会自动采集后上报。
CPU异常可以在端上模拟异常场景,然后等待端上检测异常上报后,在平台查看异常数据。
添加以下代码,模拟CPU异常:

for (int i = 0; i < 6; i++) {
    new Thread(new Runnable() {
        @Override
        public void run() {
            while (true) {
                Math.acos(Math.cos(java.lang.Double.valueOf(9999999)));
            }
        }
    },"cpu-"+i).start();
}

打开debug开关后,在Logcat日志中过滤ApmInsight,可以查看以下日志:

//CPU异常数据
2021-12-30 15:29:29.512 26285-26887/com.example.apm.insight.demo D/ApmInsight: Receive:ExceptionCpuData
//CPU指标
2021-12-30 15:29:29.512 26285-26887/com.example.apm.insight.demo D/ApmInsight: Receive: ProcessCpuDat

磁盘监控

测试阶段建议将磁盘相关配置项的采样率都配置为100%,磁盘相关配置项的阈值都配置为1,最大上报异常文件个数使用默认值20,端上设置 builder.debugMode(true)
App一次启动只会上报1次磁盘数据。为了降低对性能的影响,SDK默认为App在后台时才会采集上报一次磁盘数据,按照测试阶段建议配置后,您可以设置debug模式在前台也可以采集上报磁盘数据。 冷启动后过滤ApmInsight会看到Receive:DiskData的日志,代表磁盘监控数据上报成功,可以在磁盘异常页面查看数据。

流量监控

初始化SDK时,打开流量开关。App启动后,端上采样命中会自动采集上报流量数据。流量指标10分钟采集一次。流量异常需要端上10分钟流量消耗超过平台配置的阈值。
添加以下代码,模拟流量异常:

//十分钟流量
2023-01-12 21:10:49.615 5472-5576/com.example.apm.insight.demo D/ApmInsight: TrafficData10
//流量异常
2023-01-12 21:10:49.615 5472-5576/com.example.apm.insight.demo D/ApmInsight: TrafficDataException