如何捕获应用崩溃信息（CPP_CRASH、JS_CRASH、APP_FREEZE）并上报给自己的服务器？（应用订阅系统事件）？

Question

问题场景：

用户需要在另一个进程里收集用户产生的日志及crash文件，并上报给自己的服务器。或者是在应用发生CPP_CRASH、JS_CRASH、APP_FREEZE后便于监听相应的崩溃信息进行处理。

Answer 1

解决方案 ：

HiAppEvent类似ios metrickit的接口设计，由系统决定回调的时机。faultlog能查询的，hiappevent都将提供回调。使用这种机制，可以获取的应用奔溃事件结构化日志。

HiAppEvent运营&运维事件软件模块，用于连接APP开发者、APM上传模块、HiView故障维测服务。支撑应用开发者完成运营和运维的数据分析工作。

主要通过如下措施支持开发者快速完成APP线上的运营和运维功能。

措施1：开放系统事件订阅API，可以订阅到系统检测到APP相关事件，包括崩溃、卡死等。

措施2：开放自定义事件API，开发者可以本地记录事件、本地记录用户属性。

措施3：开放故障日志，开发者订阅系统事件后同步可获取相关故障的日志。

措施4：开放数据处理者API，开发者可以选择华为提供的分析服务。

事件定义说明事件领域（domain）用于标识事件的领域，建议设置为业务模块名称，以便于区分不同的业务模块。事件名称(name)用于指定事件的名称，建议设置为具体的业务名称，以便于描述实际的业务意义。事件类型(eventType)

用于指定事件的类型，支持以下四种类型事件：

·

• 行为事件：用于记录用户日常操作行为的事件，例如按钮点击、界面跳转等行为。
• 故障事件：用于定位和分析应用故障的事件，例如界面卡顿、掉网掉话等异常。
• 统计事件：用于统计和度量应用关键行为的事件，例如对使用时长、访问数等的统计。
• 安全事件：用于记录涉及应用安全行为的事件，例如密码修改、用户授权等行为。

事件参数(params)用于指定事件的参数，每个事件可以包含一组参数，建议设置为事件属性或事件发生上下文信息，以便于描述事件的详细信息。

使用hiAppEvent进行崩溃的监听，在应用崩溃之后，用户可以通过在次进入应用，进行崩溃信息的处理。在应用再次启动时会有个几十秒的等待时间处理。

核心代码如下：

添加应用崩溃事件观察者方法，通过以下接口订阅系统采集的故障事件：

hiAppEvent.addWatcher({
   // 开发者可以自定义观察者名称，系统会使用名称来标识不同的观察者
   name: "watcher2",
   // 开发者可以订阅感兴趣的系统事件，此处是订阅了崩溃事件
   appEventFilters: [
     {
       domain: hiAppEvent.domain.OS,
       names: [hiAppEvent.event.APP_CRASH]
     }
   ],
   // 开发者可以自行实现订阅实时回调函数，以便对订阅获取到的事件数据进行自定义处理
   onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
     hilog.info(0x0000, 'testTag', `HiAppEvent onReceive: domain=${domain}`);
     for (const eventGroup of appEventGroups) {
       // 开发者可以根据事件集合中的事件名称区分不同的系统事件
       hilog.info(0x0000, 'testTag', `HiAppEvent eventName=${eventGroup.name}`);
       for (const eventInfo of eventGroup.appEventInfos) {
         // 开发者可以获取事件领域
         hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.domain=${eventInfo.domain}`);
          // 开发者可以获取事件名称
         hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.name=${eventInfo.name}`);
         // 开发者可以获取事件类型
         hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.eventType=${eventInfo.eventType}`);
         // 开发者可以获取到事件发生的时间戳
         hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.time=${eventInfo.params['time']}`);
         // 开发者可以获取到事件随机ID
         hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.uuid=${eventInfo.params['uuid']}`);
       }
     }
   }
 });

接入华为提供的云侧服务：

//配置需要上传的事件
let eventConfig: hiAppEvent.AppEventReportConfig = {
      domain: 'button',
      name: 'click',
      isRealTime: true
};
//配置要使用的华为云属性
let processor: hiAppEvent.Processor = {
  name: 'analytics_demo',
  debugMode: true,
  routeInfo: 'CN',
  onStartReport: true,
  onBackgroundReport: true,
  periodReport: 10,
  batchReport: 5,
  userIds: ['testUserIdName'],
  userProperties: ['testUserPropertyName'],
  eventConfigs: [eventConfig]
};
//添加数据处理者
this.processorId = hiAppEvent.addProcessor(processor);

崩溃模拟：

//QueryCrashDialog.ets
  Button("app-Freeze").onClick(()=>{
          // 在按钮点击函数中构造一个freeze场景，触发应用卡死事件
          setTimeout(() => {
            while (true) {}
          }, 1000)
        })
 
 
        Button("js-Crash").onClick(()=>{
          // 在按钮点击函数中构造一个crash场景，触发应用崩溃事件
          let result: object = JSON.parse("");
        })
 
 
        Button("Cpp-Crash").onClick(()=>{
          // 在按钮点击函数中构造一个crash场景，触发应用崩溃事件
          hilog.info(0x0000, 'testTag', 'Test NAPI 2 + 3 = %{public}d', testNapi.add(2, 3));
        })

获取故障日志：

系统检测到故障并生成的日志，会存储在应用沙箱内的log目录，具体路径为/data/storage/el2/log，当前该目录已经创建，故障日志的生成正在设计和开发，开发者可以在应用内获取到事件和日志。

实现效果：