1# HiSysEvent工具使用指导<a name="ZH-CN_TOPIC_0000001231614021"></a> 2 3 4## 概述<a name="section1886702718521"></a> 5 6目前在系统的/system/bin目录下预置了hisysevent工具，开发者可以通过此工具实时订阅HiSysEvent事件及查询历史HiSysEvent事件。 7 8## 实时订阅HiSysEvent事件相关命令<a name="section1210623418527"></a> 9 10- 实时订阅HiSysEvent事件的基础命令： 11 12 ``` 13 hisysevent -r 14 ``` 15 16 选项说明： 17 18 | 选项名称 | 功能说明 | 19 | -------- | --------- | 20 | -r | 以缺省设置实时订阅HiSysEvent事件，在此种订阅方式下有任何实时HiSysEvent事件产生，都会在控制台上打印此HiSysEvent事件 | 21 22- 打开调试模式： 23 24 ``` 25 hisysevent -r -d 26 ``` 27 28 选项说明： 29 30 | 选项名称 | 功能说明 | 31 | -------- | --------- | 32 | -d | 在调试模式下实时订阅HiSysEvent事件 | 33 34- 通过事件标签方式实时订阅HiSysEvent事件： 35 36 ``` 37 hisysevent -r -t <tag> [-c [WHOLE_WORD|PREFIX|REGULAR]] 38 ``` 39 40 选项说明： 41 42 | 选项名称 | 功能说明 | 43 | -------- | --------- | 44 | -t | 设置实时订阅的HiSysEvent事件标签，用来过滤订阅的HiSysEvent事件。 | 45 | -c | 设置实时订阅的HiSysEvent事件标签匹配规则，有“WHOLE_WORD”、“PREFIX”、“REGULAR”三种匹配规则。 | 46 47 命令实例： 48 49 ``` 50 # hisysevent -r -t "TAG" -c PREFIX 51 {"domain_":"ArkUI","name_":"UI_BLOCK_6S","type_":1,"time_":1501940269812,"tz_":"+0000","tag_":"TAG1","pid_":1428,"tid_":1452,"uid_":10001,"level_":"CRITICAL","info_":""} 52 # hisysevent -r -t "TA\w{0,1}" -c REGULAR 53 {"domain_":"WINDOWMANAGER","name_":"NO_FOCUS_WINDOW","type_":1,"time_":1501940269802,"tz_":"+0000","tag_":"TAG","pid_":1428,"tid_":1433,"uid_":10001,"level_":"CRITICAL","info_":""} 54 {"domain_":"ArkUI","name_":"UI_BLOCK_6S","type_":1,"time_":1501940269812,"tz_":"+0000","tag_":"TAG1","pid_":1428,"tid_":1452,"uid_":10001,"level_":"CRITICAL","info_":""} 55 # hisysevent -r -t "TA\w+" -c REGULAR 56 {"domain_":"WINDOWMANAGER","name_":"NO_FOCUS_WINDOW","type_":1,"time_":1501940269802,"tz_":"+0000","tag_":"TAG","pid_":1428,"tid_":1433,"uid_":10001,"level_":"CRITICAL","info_":""} 57 {"domain_":"ArkUI","name_":"UI_BLOCK_6S","type_":1,"time_":1501940269812,"tz_":"+0000","tag_":"TAG1","pid_":1428,"tid_":1452,"uid_":10001,"level_":"CRITICAL","info_":""} 58 ``` 59 60- 通过事件领域及事件名称的方式实时订阅HiSysEvent事件： 61 62 ``` 63 hisysevent -r -o <domain> -n <eventName> [-c [WHOLE_WORD|PREFIX|REGULAR]] 64 ``` 65 66 选项说明： 67 68 | 选项名称 | 功能说明 | 69 | -------- | --------- | 70 | -o | 设置实时订阅的HiSysEvent事件领域，用来过滤订阅的HiSysEvent事件。 | 71 | -n | 设置实时订阅的HiSysEvent事件名称，用来过滤订阅的HiSysEvent事件。 | 72 | -c | 设置实时订阅的HiSysEvent事件领域及事件名称的匹配规则，有“WHOLE_WORD”、“PREFIX”、“REGULAR”三种匹配规则。 | 73 74 命令实例： 75 76 ``` 77 # hisysevent -r -o "DOMAINA" -n "EVENTNAMEA" 78 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":1501940269802,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 79 # hisysevent -r -o "DOMA\w{0,10}" -n "EVENT\w+" -c REULAR 80 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":1501940269802,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 81 {"domain_":"DOMAINABC","name_":"EVENTNAMEABC","type_":1,"time_":1501940269938,"tz_":"+0000","pid_":1428,"tid_":1336,"uid_":10002,"level_":"CRITICAL","info_":""} 82 # hisysevent -r -o "DOMA\w{0,10}" -c REGULAR 83 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":1501940269802,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 84 {"domain_":"DOMAINABC","name_":"EVENTNAMEABC","type_":1,"time_":1501940269938,"tz_":"+0000","pid_":1428,"tid_":1336,"uid_":10002,"level_":"CRITICAL","info_":""} 85 {"domain_":"DOMAINABC","name_":"EVENTNAMEB","type_":1,"time_":1501940279938,"tz_":"+0000","pid_":1428,"tid_":1344,"uid_":10002,"level_":"CRITICAL","info_":""} 86 ``` 87 88 > **说明：** 89 >当同时通过-t、-o及-n指定了相关订阅规则参数设置，则判断设置的事件标签是否为空，若不为空，则使用事件标签规则进行订阅，否则使用事件领域及事件名称订阅规则进行订阅。 90 91## 查询历史HiSysEvent事件相关命令<a name="section1210623418539"></a> 92 93- 查询历史HiSysEvent事件的基础命令： 94 95 ``` 96 hisysevent -l 97 ``` 98 99 选项说明： 100 101 | 选项名称 | 功能说明 | 102 | -------- | --------- | 103 | -l | 以缺省设置查询历史HiSysEvent事件，此次查询会返回最近不多于1000条的HiSysEvent事件。 | 104 105- 通过设置开始/结束时间，过滤查询历史HiSysEvent事件的结果的命令： 106 107 ``` 108 hisysevent -l -s <begin time> -e <end time> 109 ``` 110 111 选项说明： 112 113 | 选项名称 | 功能说明 | 114 | -------- | --------- | 115 | -s | 设置查询历史HiSysEvent事件的开始时间，此次查询只会返回不早于该时间点的HiSysEvent事件。 | 116 | -e | 设置查询历史HiSysEvent事件的结束时间，此次查询只会返回不晚于该时间点的HiSysEvent事件。 | 117 118 命令实例： 119 120 ``` 121 # hisysevent -l -s 20207388633 -e 20207389000 122 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207388633,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 123 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207388634,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 124 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207388900,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 125 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207389000,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 126 ``` 127 128- 通过设置最大数量值，限制查询历史HiSysEvent事件的数量： 129 130 ``` 131 hisysevent -l -m <max hisysevent count> 132 ``` 133 134 选项说明： 135 136 | 选项名称 | 功能说明 | 137 | -------- | --------- | 138 | -m | 设置查询历史HiSysEvent事件的数量，有效值范围[0,1000]，此次查询返回的HiSysEvent事件数目不会多于此值。 | 139 140 命令实例： 141 142 ``` 143 # hisysevent -l -s 20207388633 -e 20207389000 -m 3 144 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207388634,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 145 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207388900,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 146 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207389000,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 147 # hisysevent -l -m 2 148 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207388633,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 149 {"domain_":"DOMAINA","name_":"EVENTNAMEA","type_":1,"time_":20207388634,"tz_":"+0000","pid_":1428,"tid_":1333,"uid_":10002,"level_":"CRITICAL","info_":""} 150 ``` 151
