1# 卡死事件介绍
2
3HiAppEvent提供接口用于订阅系统卡死事件。
4
5- [订阅卡死事件(ArkTS)](hiappevent-watcher-freeze-events-arkts.md)
6- [订阅卡死事件(C/C++)](hiappevent-watcher-freeze-events-ndk.md)
7
8卡死事件信息中params属性的详细描述如下:
9
10**params属性:**
11
12| 名称    | 类型   | 说明                       |
13| ------- | ------ | ------------------------- |
14| time     | number | 事件触发时间,单位为毫秒。 |
15| foreground | boolean | 应用是否处于前台状态。 |
16| bundle_version | string | 应用版本。 |
17| bundle_name | string | 应用名称。 |
18| process_name | string | 应用的进程名称。 |
19| pid | number | 应用的进程id。|
20| uid | number | 应用的用户id。 |
21| uuid | string | 故障id。 |
22| exception | object | 异常信息,详见exception属性。 |
23| hilog | string[] | 日志信息。|
24| event_handler | string[] | 主线程未处理消息。 |
25| event_handler_size_3s | string | THREAD_BLOCK事件3s时任务栈中任务数。 |
26| event_handler_size_6s | string | THREAD_BLOCK事件6s时任务栈中任务数。 |
27| peer_binder | string[] | binder调用信息。 |
28| threads | object[] | 全量线程调用栈,详见thread属性。 |
29| memory | object | 内存信息,详见memory属性。 |
30| external_log<sup>12+</sup> | string[] | 故障日志文件路径。**为避免目录空间超限(限制参考log_over_limit),导致新生成的日志文件写入失败,日志文件处理完后请及时删除。** |
31| log_over_limit<sup>12+</sup> | boolean | 生成的故障日志文件与已存在的日志文件总大小是否超过5M上限。true表示超过上限,日志写入失败;false表示未超过上限。 |
32
33**exception属性:**
34
35| 名称    | 类型   | 说明                       |
36| ------- | ------ | ------------------------- |
37| name | string | 异常类型。 |
38| message | string | 异常原因。 |
39
40**thread属性:**
41
42| 名称    | 类型   | 说明                       |
43| ------- | ------ | ------------------------- |
44| thread_name | string | 线程名。 |
45| tid | number | 线程id。 |
46| frames | object[] | 线程调用栈,详见frame属性。 |
47
48**frame属性:**
49
50| 名称    | 类型   | 说明                       |
51| ------- | ------ | ------------------------- |
52| symbol | string | 函数名称。 |
53| file | string | 文件名。 |
54| buildId | string | 文件唯一标识。 |
55| pc | string | pc寄存器地址。 |
56| offset | number | 函数偏移量。 |
57
58**memory属性:**
59
60| 名称    | 类型   | 说明                       |
61| ------- | ------ | ------------------------- |
62| rss | number | 进程实际占用内存大小,单位KB。 |
63| vss | number | 进程向系统申请的虚拟内存大小,单位KB。 |
64| pss | number | 进程实际使用的物理内存大小,单位KB。 |
65| sys_free_mem | number | 空闲内存大小,单位KB。 |
66| sys_avail_mem | number | 可用内存大小,单位KB。 |
67| sys_total_mem | number | 总内存大小,单位KB。 |
68