Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
d974eae4
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
d974eae4
编写于
2月 09, 2022
作者:
X
xuyong
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
hisysevent tag订阅文档更新
Signed-off-by:
N
xuyong
<
xuyong59@huawei.com
>
上级
42b3b158
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
236 addition
and
234 deletion
+236
-234
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-tool.md
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-tool.md
+61
-61
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-write-config.md
...vice-dev/subsystems/subsys-dfx-hisysevent-write-config.md
+170
-170
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-write.md
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-write.md
+5
-3
未找到文件。
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-tool.md
浏览文件 @
d974eae4
...
...
@@ -10,93 +10,93 @@
## 实时订阅HiSysEvent事件相关命令<a name="section1210623418527"></a>
-
实时订阅HiSysEvent事件的基础命令:
-
实时订阅HiSysEvent事件的基础命令:
```
hisysevent -r
```
```
hisysevent -r
```
选项说明:
选项说明:
| 选项名称 | 功能说明 |
| -------- | --------- |
| -r
| 以缺省设置实时订阅HiSysEvent事件,在此种订阅方式下有任何实时HiSysEvent事件产生,都会在控制台上打印此HiSysEvent事件 |
| 选项名称 | 功能说明 |
| -------- | --------- |
| -r | 以缺省设置实时订阅HiSysEvent事件,在此种订阅方式下有任何实时HiSysEvent事件产生,都会在控制台上打印此HiSysEvent事件 |
-
打开调试模式:
-
打开调试模式:
```
hisysevent -r -d
```
```
hisysevent -r -d
```
选项说明:
选项说明:
| 选项名称 | 功能说明 |
| -------- | --------- |
| -d | 在调试模式下实时订阅HiSysEvent事件 |
| 选项名称 | 功能说明 |
| -------- | --------- |
| -d | 在调试模式下实时订阅HiSysEvent事件 |
-
通过事件标签方式实时订阅HiSysEvent事件:
-
通过事件标签方式实时订阅HiSysEvent事件:
```
hisysevnet -r -t <tag> [-c [WHOLE_WORD|PREFIX|REGULAR]]
```
```
hisysevnet -r -t <tag> [-c [WHOLE_WORD|PREFIX|REGULAR]]
```
选项说明:
选项说明:
| 选项名称 | 功能说明 |
| -------- | --------- |
| -t
| 设置实时订阅的HiSysEvent事件标签,用来过滤订阅的HiSysEvent事件 |
| -c
| 设置实时订阅的HiSysEvent事件标签匹配规则,有“WHOLE_WORD”、“PREFIX”、“REGULAR”三种匹配规则|
| 选项名称 | 功能说明 |
| -------- | --------- |
| -t | 设置实时订阅的HiSysEvent事件标签,用来过滤订阅的HiSysEvent事件 |
| -c | 设置实时订阅的HiSysEvent事件标签匹配规则,有“WHOLE_WORD”、“PREFIX”、“REGULAR”三种匹配规则|
-
通过事件领域及事件名称的方式实时订阅HiSysEvent事件:
-
通过事件领域及事件名称的方式实时订阅HiSysEvent事件:
```
hisysevent -r -o <domain> -n <eventName> [-c [WHOLE_WORD|PREFIX|REGULAR]]
```
```
hisysevent -r -o <domain> -n <eventName> [-c [WHOLE_WORD|PREFIX|REGULAR]]
```
| 选项名称 | 功能说明 |
| -------- | --------- |
| -o | 设置实时订阅的HiSysEvent事件领域,用来过滤订阅的HiSysEvent事件 |
| -n | 设置实时订阅的HiSysEvent事件名称,用来过滤订阅的HiSysEvent事件|
| -c | 设置实时订阅的HiSysEvent事件领域及事件名称的匹配规则,有“WHOLE_WORD”、“PREFIX”、“REGULAR”三种匹配规则|
| 选项名称 | 功能说明 |
| -------- | --------- |
| -o | 设置实时订阅的HiSysEvent事件领域,用来过滤订阅的HiSysEvent事件 |
| -n | 设置实时订阅的HiSysEvent事件名称,用来过滤订阅的HiSysEvent事件|
| -c | 设置实时订阅的HiSysEvent事件领域及事件名称的匹配规则,有“WHOLE_WORD”、“PREFIX”、“REGULAR”三种匹配规则|
>![](../public_sys-resources/icon-note.gif) **说明:**
>当同时通过-t、-o及-n指定了相关订阅规则参数设置,则判断设置的事件标签是否为空,若不为空,则使用事件标签规则进行订阅,否则使用事件领域及事件名称订阅规则进行订阅。
>![](../public_sys-resources/icon-note.gif) **说明:**
>当同时通过-t、-o及-n指定了相关订阅规则参数设置,则判断设置的事件标签是否为空,若不为空,则使用事件标签规则进行订阅,否则使用事件领域及事件名称订阅规则进行订阅。
## 查询历史HiSysEvent事件相关命令<a name="section1210623418539"></a>
-
查询历史HiSysEvent事件的基础命令:
-
查询历史HiSysEvent事件的基础命令:
```
hisysevent -l
```
```
hisysevent -l
```
选项说明:
选项说明:
| 选项名称 | 功能说明 |
| -------- | --------- |
| -l | 以缺省设置查询历史HiSysEvent事件,此次查询会返回最近不多于1000条的HiSysEvent事件 |
| 选项名称 | 功能说明 |
| -------- | --------- |
| -l | 以缺省设置查询历史HiSysEvent事件,此次查询会返回最近不多于1000条的HiSysEvent事件 |
-
通过设置开始/结束时间,过滤查询历史HiSysEvent事件的结果的命令:
-
通过设置开始/结束时间,过滤查询历史HiSysEvent事件的结果的命令:
```
hisysevent -l -s <begin time> -e <end time>
```
```
hisysevent -l -s <begin time> -e <end time>
```
选项说明:
选项说明:
| 选项名称 | 功能说明 |
| -------- | --------- |
| -s | 设置查询历史HiSysEvent事件的开始时间,此次查询只会返回不早于该时间点的HiSysEvent事件 |
| -e | 设置查询历史HiSysEvent事件的结束时间,此次查询只会返回不晚于该时间点的HiSysEvent事件 |
| 选项名称 | 功能说明 |
| -------- | --------- |
| -s | 设置查询历史HiSysEvent事件的开始时间,此次查询只会返回不早于该时间点的HiSysEvent事件 |
| -e | 设置查询历史HiSysEvent事件的结束时间,此次查询只会返回不晚于该时间点的HiSysEvent事件 |
-
通过设置最大数量值,限制查询历史HiSysEvent事件的数量:
-
通过设置最大数量值,限制查询历史HiSysEvent事件的数量:
```
hisysevent -l -m <max hisysevent count>
```
```
hisysevent -l -m <max hisysevent count>
```
选项说明:
选项说明:
| 选项名称 | 功能说明 |
| -------- | --------- |
| -m | 设置查询历史HiSysEvent事件的数量,有效值范围[0,1000],此次查询返回的HiSysEvent事件数目不会多于此值。 |
| 选项名称 | 功能说明 |
| -------- | --------- |
| -m | 设置查询历史HiSysEvent事件的数量,有效值范围[0,1000],此次查询返回的HiSysEvent事件数目不会多于此值。 |
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-write-config.md
浏览文件 @
d974eae4
...
...
@@ -39,133 +39,133 @@
-
每个事件名称可定义多个参数,同一个事件名称内部的参数不能重名,每个事件名称
**有且只有**
一个名称为__BASE的参数,此参数字段组成如表1,他自定义参数,具体字段组成如表2。
**表 1**
__BASE参数字段说明
<a
name=
"table1844019587513"
></a>
<table><thead
align=
"left"
><tr
id=
"row1440058186118"
><th
class=
"cellrowborder"
valign=
"top"
id=
"mcps1.2.3.1.1"
><p
id=
"p19441135865020"
><a
name=
"p19441135845020"
></a><a
name=
"p19441135865020"
></a>
字段名称
</p>
</th>
<th
class=
"cellrowborder"
valign=
"top"
id=
"mcps1.2.3.1.2"
><p
id=
"p13441195865593"
><a
name=
"p13441195865593"
></a><a
name=
"p13441195865593"
></a>
描述
</p>
</th>
</tr>
</thead>
<tbody><tr
id=
"row16441155868499"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p877916438213"
><a
name=
"p877916438613"
></a><a
name=
"p877916438613"
></a>
type
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727325136218"
><a
name=
"p14727325136218"
></a><a
name=
"p14727325136218"
></a>
字段说明:
<br>
  
必选字段,用来标识该事件名称的类型。
</p>
<p
id=
"p167271525203615"
><a
name=
"p167271525203615"
></a><a
name=
"p167271525203615"
></a>
取值范围:
</p>
<a
name=
"ul6717142214621"
></a><a
name=
"ul6717142214621"
></a>
<ul
id=
"ul6717142214621"
>
<li>
FAULT:错误类型。
</li>
<li>
STATISTIC:统计类型。
</li>
<li>
SECURITY:安全性。
</li>
<li>
BEHAVIOR:用户行为。
</li>
</ul>
</td>
</tr>
<tr
id=
"row16441155818699"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p877916438616"
><a
name=
"p877916438616"
></a><a
name=
"p877916438616"
></a>
level
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727325153218"
><a
name=
"p14727325153218"
></a><a
name=
"p14727325153218"
></a>
字段作用:
<br>
  
必选字段,用来标识该事件名称的级别。
</p>
<p
id=
"p167271525213215"
><a
name=
"p167271525213215"
></a><a
name=
"p167271525213215"
></a>
取值范围:
</p>
<a
name=
"ul6717142215021"
></a><a
name=
"ul6717142215021"
></a>
<ul
id=
"ul6717142215021"
>
<li>
CRITICAL:严重。
</li>
<li>
MINOR:一般。
</li>
</ul>
</td>
</tr>
<tr
id=
"row16441155818519"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p877916458213"
><a
name=
"p877916458213"
></a><a
name=
"p877916458213"
></a>
tag
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727327733218"
><a
name=
"p14727327733218"
></a><a
name=
"p14727327733218"
></a>
字段作用:
<br>
  
可选字段,用来标识该事件名称的标签。
</p>
<p
id=
"p167271395203215"
><a
name=
"p167271395203215"
></a><a
name=
"p167271395203215"
></a>
定义规则:
</p>
<a
name=
"ul6717143414921"
></a><a
name=
"ul6717143414921"
></a>
<ul
id=
"ul6717143414921"
>
<li>
最多可同时定义5个标签,标签之间使用空格来分隔。
</li>
<li>
单个标签最多包含16个字符,字符范围[a-zA-Z0-9]。
</li>
</ul>
</td>
</tr>
<tr
id=
"row16441155817799"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p877916477213"
><a
name=
"p877916477213"
></a><a
name=
"p877916477213"
></a>
desc
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727725133218"
><a
name=
"p14727725133218"
></a><a
name=
"p14727725133218"
></a>
字段作用:
<br>
  
必选字段,用来对该事件名称进行描述。
</p>
<p
id=
"p167277525203215"
><a
name=
"p167277525203215"
></a><a
name=
"p167277525203215"
></a>
定义规则:
</p>
<a
name=
"ul6777142214921"
></a><a
name=
"ul6777142214921"
></a>
<ul
id=
"ul6777142214921"
>
<li>
至少包含3个字符,最多包含128个字符,字符范围[a-zA-Z0-9 _]
</li>
</ul>
</td>
</tr>
</tbody>
</table>
**表 2**
自定义参数字段说明
<a
name=
"table1844019587523"
></a>
<table><thead
align=
"left"
><tr
id=
"row1440060185118"
><th
class=
"cellrowborder"
valign=
"top"
id=
"mcps1.2.3.1.1"
><p
id=
"p19442235845020"
><a
name=
"p19442235845020"
></a><a
name=
"p19442235845020"
></a>
字段名称
</p>
</th>
<th
class=
"cellrowborder"
valign=
"top"
id=
"mcps1.2.3.1.2"
><p
id=
"p13331195815593"
><a
name=
"p13331195815593"
></a><a
name=
"p13331195815593"
></a>
描述
</p>
</th>
</tr>
</thead>
<tbody><tr
id=
"row16441232818499"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p8779163453213"
><a
name=
"p8779163453213"
></a><a
name=
"p8779163453213"
></a>
type
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727325235218"
><a
name=
"p14727325235218"
></a><a
name=
"p14727325235218"
></a>
字段说明:
<br>
  
必选字段,用来标识该参数的类型。
</p>
<p
id=
"p167271372203215"
><a
name=
"p167271372203215"
></a><a
name=
"p167271372203215"
></a>
取值范围:
</p>
<a
name=
"ul6717342214921"
></a><a
name=
"ul6717342214921"
></a>
<ul
id=
"ul6717134514921"
>
<li>
BOOL
</li>
<li>
INT8
</li>
<li>
UINT8
</li>
<li>
INT16
</li>
<li>
UINT16
</li>
<li>
INT32
</li>
<li>
UINT32
</li>
<li>
INT64
</li>
<li>
UINT64
</li>
<li>
FLOAT
</li>
<li>
DOUBLE
</li>
<li>
STRING
</li>
</ul>
</td>
</tr>
<tr
id=
"row16326155818499"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p877567438213"
><a
name=
"p877567438213"
></a><a
name=
"p877567438213"
></a>
arrsize
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727324893218"
><a
name=
"p14727324893218"
></a><a
name=
"p14727324893218"
></a>
字段作用:
<br>
  
可选字段,用来标识数组类型参数的长度。
</p>
<p
id=
"p1672715498703215"
><a
name=
"p1672715498703215"
></a><a
name=
"p1672715498703215"
></a>
取值范围:
<br>
  
1~100
</p>
</ul>
</td>
</tr>
<tr
id=
"row16556155818499"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p845916438213"
><a
name=
"p845916438213"
></a><a
name=
"p845916438213"
></a>
desc
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727343133218"
><a
name=
"p14727343133218"
></a><a
name=
"p14727343133218"
></a>
字段作用:
<br>
  
必选字段,用来对该参数进行描述。
</p>
<p
id=
"p167271524323215"
><a
name=
"p167271524323215"
></a><a
name=
"p167271524323215"
></a>
定义规则:
</p>
<a
name=
"ul6717142111921"
></a><a
name=
"ul6717142111921"
></a>
<ul
id=
"ul6717156714921"
>
<li>
至少包含3个字符,最多包含128个字符,字符范围[a-zA-Z0-9 _]
</li>
</ul>
</td>
</tr>
</tbody>
</table>
**表 1** __BASE参数字段说明
<a name="table1844019587513"></a>
<table><thead align="left"><tr id="row1440058186118"><th class="cellrowborder" valign="top" id="mcps1.2.3.1.1"><p id="p19441135865020"><a name="p19441135845020"></a><a name="p19441135865020"></a>字段名称</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.3.1.2"><p id="p13441195865593"><a name="p13441195865593"></a><a name="p13441195865593"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row16441155868499">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p877916438213"><a name="p877916438613"></a><a name="p877916438613"></a>type</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727325136218"><a name="p14727325136218"></a><a name="p14727325136218"></a>字段说明:<br>  必选字段,用来标识该事件名称的类型。</p>
<p id="p167271525203615"><a name="p167271525203615"></a><a name="p167271525203615"></a>取值范围:</p>
<a name="ul6717142214621"></a><a name="ul6717142214621"></a>
<ul id="ul6717142214621">
<li>FAULT:错误类型。</li>
<li>STATISTIC:统计类型。</li>
<li>SECURITY:安全性。</li>
<li>BEHAVIOR:用户行为。</li>
</ul>
</td>
</tr>
<tr id="row16441155818699">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p877916438616"><a name="p877916438616"></a><a name="p877916438616"></a>level</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727325153218"><a name="p14727325153218"></a><a name="p14727325153218"></a>字段作用:<br>  必选字段,用来标识该事件名称的级别。</p>
<p id="p167271525213215"><a name="p167271525213215"></a><a name="p167271525213215"></a>取值范围:</p>
<a name="ul6717142215021"></a><a name="ul6717142215021"></a>
<ul id="ul6717142215021">
<li>CRITICAL:严重。</li>
<li>MINOR:一般。</li>
</ul>
</td>
</tr>
<tr id="row16441155818519">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p877916458213"><a name="p877916458213"></a><a name="p877916458213"></a>tag</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727327733218"><a name="p14727327733218"></a><a name="p14727327733218"></a>字段作用:<br>  可选字段,用来标识该事件名称的标签。</p>
<p id="p167271395203215"><a name="p167271395203215"></a><a name="p167271395203215"></a>定义规则:</p>
<a name="ul6717143414921"></a><a name="ul6717143414921"></a>
<ul id="ul6717143414921">
<li>最多可同时定义5个标签,标签之间使用空格来分隔。</li>
<li>单个标签最多包含16个字符,字符范围[a-zA-Z0-9]。</li>
</ul>
</td>
</tr>
<tr id="row16441155817799">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p877916477213"><a name="p877916477213"></a><a name="p877916477213"></a>desc</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727725133218"><a name="p14727725133218"></a><a name="p14727725133218"></a>字段作用:<br>  必选字段,用来对该事件名称进行描述。</p>
<p id="p167277525203215"><a name="p167277525203215"></a><a name="p167277525203215"></a>定义规则:</p>
<a name="ul6777142214921"></a><a name="ul6777142214921"></a>
<ul id="ul6777142214921">
<li>至少包含3个字符,最多包含128个字符,字符范围[a-zA-Z0-9 _]</li>
</ul>
</td>
</tr>
</tbody>
</table>
**表 2** 自定义参数字段说明
<a name="table1844019587523"></a>
<table><thead align="left"><tr id="row1440060185118"><th class="cellrowborder" valign="top" id="mcps1.2.3.1.1"><p id="p19442235845020"><a name="p19442235845020"></a><a name="p19442235845020"></a>字段名称</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.3.1.2"><p id="p13331195815593"><a name="p13331195815593"></a><a name="p13331195815593"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row16441232818499">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p8779163453213"><a name="p8779163453213"></a><a name="p8779163453213"></a>type</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727325235218"><a name="p14727325235218"></a><a name="p14727325235218"></a>字段说明:<br>  必选字段,用来标识该参数的类型。</p>
<p id="p167271372203215"><a name="p167271372203215"></a><a name="p167271372203215"></a>取值范围:</p>
<a name="ul6717342214921"></a><a name="ul6717342214921"></a>
<ul id="ul6717134514921">
<li>BOOL</li>
<li>INT8</li>
<li>UINT8</li>
<li>INT16</li>
<li>UINT16</li>
<li>INT32</li>
<li>UINT32</li>
<li>INT64</li>
<li>UINT64</li>
<li>FLOAT</li>
<li>DOUBLE</li>
<li>STRING</li>
</ul>
</td>
</tr>
<tr id="row16326155818499">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p877567438213"><a name="p877567438213"></a><a name="p877567438213"></a>arrsize</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727324893218"><a name="p14727324893218"></a><a name="p14727324893218"></a>字段作用:<br>  可选字段,用来标识数组类型参数的长度。</p>
<p id="p1672715498703215"><a name="p1672715498703215"></a><a name="p1672715498703215"></a>取值范围:<br>   1~100</p>
</ul>
</td>
</tr>
<tr id="row16556155818499">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p845916438213"><a name="p845916438213"></a><a name="p845916438213"></a>desc</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727343133218"><a name="p14727343133218"></a><a name="p14727343133218"></a>字段作用:<br>  必选字段,用来对该参数进行描述。</p>
<p id="p167271524323215"><a name="p167271524323215"></a><a name="p167271524323215"></a>定义规则:</p>
<a name="ul6717142111921"></a><a name="ul6717142111921"></a>
<ul id="ul6717156714921">
<li>至少包含3个字符,最多包含128个字符,字符范围[a-zA-Z0-9 _]</li>
</ul>
</td>
</tr>
</tbody>
</table>
## 编写yaml文件<a name="section123181432175113"></a>
...
...
@@ -189,24 +189,24 @@
-
EVENT_NAMEA被定义成错误类型的严重事件,该事件包含类型为字符串类型的NAME1参数、字符串类型的NAME2参数及无符号短整型类型的NAME3参数,可以通过事件领域MODULEA和事件名称EVENT_NAMEA对其进行
[
实时订阅
](
subsys-dfx-hisysevent-read.md
)
。
-
EVENT_NAMEB被定义成统计类型的一般事件,EVENT_NAMEB包含类型为无符号短整型类型的NAME1参数及整型类型的NAME2参数。因为EVENT_NAMEB在__BASE参数中定义了名称为tag1和tag2的两个事件标签,所以不仅可以通过事件领域MODULEA和事件名称EVENT_NAMEB对其进行
[
实时订阅
](
subsys-dfx-hisysevent-read.md
)
,,所以还可以通过事件标签对该事件进行
[
实时订阅
](
subsys-dfx-hisysevent-read.md
)
。
```
##########################################
# the hisysevent definition for module a #
##########################################
domain: MODULEA
EVENT_NAMEA:
__BASE: {type: FAULT, level: CRITICAL, desc: event name a}
NAME1: {type: STRING, desc: name1}
NAME2: {type: STRING, desc: name2}
NAME3: {type: UINT16, desc: name3}
EVENT_NAMEB:
__BASE: {type: STATISTIC, level: MINOR, tag: tag1 tag2, desc: event name b}
NAME1: {type: UINT16, desc: name1}
NAME2: {type: INT32, desc: name2}
```
```
##########################################
# the hisysevent definition for module a #
##########################################
domain: MODULEA
EVENT_NAMEA:
__BASE: {type: FAULT, level: CRITICAL, desc: event name a}
NAME1: {type: STRING, desc: name1}
NAME2: {type: STRING, desc: name2}
NAME3: {type: UINT16, desc: name3}
EVENT_NAMEB:
__BASE: {type: STATISTIC, level: MINOR, tag: tag1 tag2, desc: event name b}
NAME1: {type: UINT16, desc: name1}
NAME2: {type: INT32, desc: name2}
```
## 验证yaml文件<a name="section123181432175115"></a>
...
...
@@ -285,31 +285,31 @@ EVENT_NAMEB:
./build/ohos/hisysevent/gen_def_from_all_yaml.py --yaml-list <yaml file list> --def-path <file store directory>
```
**表 3**
单文件编译参数说明
<a
name=
"table1844019587534"
></a>
<table><thead
align=
"left"
><tr
id=
"row1440056575118"
><th
class=
"cellrowborder"
valign=
"top"
id=
"mcps1.2.3.1.1"
><p
id=
"p19432435845020"
><a
name=
"p19432435845020"
></a><a
name=
"p19432435845020"
></a>
选项名称
</p>
</th>
<th
class=
"cellrowborder"
valign=
"top"
id=
"mcps1.2.3.1.2"
><p
id=
"p13441196715593"
><a
name=
"p13441196715593"
></a><a
name=
"p13441196715593"
></a>
描述
</p>
</th>
</tr>
</thead>
<tbody><tr
id=
"row16441155854499"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p877916558213"
><a
name=
"p877916558213"
></a><a
name=
"p877916558213"
></a>
--yaml-list
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727325133218"
><a
name=
"p14727325133218"
></a><a
name=
"p14727325133218"
></a>
指定需要编译的yaml文件路径列表,多个yaml文件路径之间用空格分隔。
</p>
</td><tr
id=
"row16441155832499"
>
<td
class=
"cellrowborder"
width=
"60%"
valign=
"top"
headers=
"mcps1.2.3.1.1 "
>
<p
id=
"p877916421213"
><a
name=
"p877916421213"
></a><a
name=
"p877916421213"
></a>
--def-path
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
headers=
"mcps1.2.3.1.2 "
>
<p
id=
"p14727323533218"
><a
name=
"p14727323533218"
></a><a
name=
"p14727323533218"
></a>
指定编译生成的hisysevent.def文件的生成路径。
</p>
</td>
</tr>
</tbody>
</table>
**表 3** 单文件编译参数说明
<a name="table1844019587534"></a>
<table><thead align="left"><tr id="row1440056575118"><th class="cellrowborder" valign="top" id="mcps1.2.3.1.1"><p id="p19432435845020"><a name="p19432435845020"></a><a name="p19432435845020"></a>选项名称</p>
</th>
<th class="cellrowborder" valign="top" id="mcps1.2.3.1.2"><p id="p13441196715593"><a name="p13441196715593"></a><a name="p13441196715593"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="row16441155854499">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p877916558213"><a name="p877916558213"></a><a name="p877916558213"></a>--yaml-list</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727325133218"><a name="p14727325133218"></a><a name="p14727325133218"></a>指定需要编译的yaml文件路径列表,多个yaml文件路径之间用空格分隔。</p>
</td><tr id="row16441155832499">
<td class="cellrowborder" width="60%" valign="top" headers="mcps1.2.3.1.1 ">
<p id="p877916421213"><a name="p877916421213"></a><a name="p877916421213"></a>--def-path</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.2.3.1.2 ">
<p id="p14727323533218"><a name="p14727323533218"></a><a name="p14727323533218"></a>指定编译生成的hisysevent.def文件的生成路径。</p>
</td>
</tr>
</tbody>
</table>
### 打点及查询定义的事件<a name="section123181432175139"></a>
...
...
zh-cn/device-dev/subsystems/subsys-dfx-hisysevent-write.md
浏览文件 @
d974eae4
# HiSysEvent打点指导<a name="ZH-CN_TOPIC_0000001231373947"></a>
-
[
概述
](
#section77571101789
)
-
[
打点配置
](
#section112771171321
)
-
[
约束与限制
](
#section123181432175224
)
-
[
接口说明
](
#section13480315886
)
-
[
开发实例
](
#section112771171317
)
...
...
@@ -9,9 +9,11 @@
HiSysEvent提供OpenHarmony打点接口,通过在关键路径打点记录系统在运行过程中的重要信息,辅助开发者定位问题,此外还支持开发者将数据上传到云进行大数据质量度量。
##
打点配置<a name="section112771171321
"></a>
##
# 约束与限制<a name="section123181432175224
"></a>
在进行HiSysEvent事件打点之前,需要先对HiSysEvent事件打点进行配置,具体可参考
[
《HiSysEvent打点配置指导》
](
subsys-dfx-hisysevent-write-config.md
)
。
**HiSysEvent事件打点条件约束:**
-
HiSysEvent事件打点结果取决于该HiSysEvent事件是否已在组件中进行配置,具体配置方法请参考
[
《HiSysEvent打点配置指导》
](
subsys-dfx-hisysevent-write-config.md
)
。
## 接口说明<a name="section13480315886"></a>
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录