崩溃事件介绍
概述
崩溃是指应用进程非预期退出。以下两种场景会生成崩溃事件：
- Native代码未处理崩溃异常信号时，会生成崩溃事件。
- Js/ArkTS代码未处理异常时，会生成崩溃事件。
本文面向开发者介绍崩溃事件各字段的含义及规格。如需了解如何使用HiAppEvent接口订阅系统崩溃事件，请参考以下文档。目前提供ArkTs和C/C++两种接口，按需选择。
事件字段说明
params字段说明
崩溃事件信息中params属性的详细描述如下：
| 名称 | 类型 | 说明 |
|---|
| time | number | 事件触发时间，单位为毫秒。 |
| crash_type | string | 崩溃类型。支持NativeCrash（native代码异常）和JsError（js代码异常）两种崩溃类型。问题分析请分别参考CppCrash分析指南和JSCrash分析指南。 |
| foreground | boolean | 应用是否处于前台状态。true表示应用处于前台状态；false表示应用处于后台状态。 |
| bundle_version | string | 应用版本。 |
| bundle_name | string | 应用名称。 |
| pid | number | 应用的进程ID。 |
| uid | number | 应用的用户ID。 |
| uuid | string | 根据故障信息生成的故障特征码，用于标识特征相同的崩溃故障。 |
| exception | object | 异常信息, 详见exception字段说明。包含故障简要信息，全量故障信息见external_log文件。 |
| hilog | string[] | 日志信息，最多显示100行hilog日志。更多日志请查看故障日志文件。 |
| threads | object[] | 全量线程调用栈，详见thread字段说明。仅NativeCrash类型的崩溃事件提供。 |
| external_log12+ | string[] | 故障日志文件路径。为避免目录空间超限导致新生成的日志文件写入失败，日志文件处理完后请及时删除，超限规格请参考log_over_limit字段。 |
| log_over_limit12+ | boolean | 生成的故障日志文件与已存在的日志文件总大小是否超过5MB上限。true表示超过上限，日志写入失败；false表示未超过上限。 |
exception字段说明
JsError类型exception字段说明
| 名称 | 类型 | 说明 |
|---|
| name | string | 异常类型。 |
| message | string | 异常原因。 |
| stack | string | 异常调用栈。 |
NativeCrash类型exception字段说明
| 名称 | 类型 | 说明 |
|---|
| message | string | 异常原因。 |
| signal | object | 信号信息，详见signal字段说明。 |
| thread_name | string | 线程名称。 |
| tid | number | 线程ID。 |
| frames | object[] | 线程调用栈，详见frame字段说明。 |
signal字段说明
信号详细介绍请参考CppCrash分析指南崩溃信号说明。
| 名称 | 类型 | 说明 |
|---|
| signo | number | 信号值。 |
| code | number | 信号二级分类。 |
| address | string | 访问出错的地址。 |
thread字段说明
| 名称 | 类型 | 说明 |
|---|
| thread_name | string | 线程名称。 |
| tid | number | 线程ID。 |
| frames | object[] | 线程调用栈，详见frame字段说明。 |
frame字段说明
Native帧frame字段说明
| 名称 | 类型 | 说明 |
|---|
| file | string | 文件名称。也可能是匿名内存映射，例如 [heap]、[stack] 等。 |
| symbol | string | 函数名称。名称长度超过256字节时将被删除，防止超长字符串引起未知问题。 |
| buildId | string | 文件唯一标识。文件可能没有buildId，请参考CppCrash分析指南崩溃日志内容说明。 |
| pc | string | 在文件内的偏移字节数。 |
| offset | number | 在函数内偏移字节数。 |
Js帧frame字段说明
| 名称 | 类型 | 说明 |
|---|
| file | string | 文件名。 |
| packageName | string | 模块包名。 |
| symbol | string | 函数名。 |
| line | number | 异常所在代码行号。 |
| column | number | 异常所在代码列号。 |
你可能感兴趣的鸿蒙文章
harmony 鸿蒙Performance Analysis Kit（性能分析服务）
harmony 鸿蒙分析AppFreeze（应用无响应）
harmony 鸿蒙应用恢复开发指导
harmony 鸿蒙分析CppCrash（进程崩溃）
harmony 鸿蒙错误管理开发指导
harmony 鸿蒙hdc
harmony 鸿蒙事件上报
harmony 鸿蒙HiAppEvent介绍
harmony 鸿蒙订阅踩内存事件（ArkTS）
harmony 鸿蒙订阅踩内存事件（C/C++）