Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
3b2abd1e
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
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,发现更多精彩内容 >>
未验证
提交
3b2abd1e
编写于
10月 12, 2022
作者:
H
hw-wLiu
提交者:
Gitee
10月 12, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/device-dev/subsystems/subsys-dfx-hitracemeter.md.
Signed-off-by:
N
hw-wLiu
<
liuwei573@huawei.com
>
上级
60d3db15
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
13 addition
and
13 deletion
+13
-13
zh-cn/device-dev/subsystems/subsys-dfx-hitracemeter.md
zh-cn/device-dev/subsystems/subsys-dfx-hitracemeter.md
+13
-13
未找到文件。
zh-cn/device-dev/subsystems/subsys-dfx-hitracemeter.md
浏览文件 @
3b2abd1e
...
...
@@ -12,7 +12,7 @@ HiTraceMeter系统主要分为三部分:
-
(2)Trace数据采集命令行工具;
-
(3)Trace数据图形分析工具。
其中,前两者运行在设备端侧,图形工具运行在PC主机侧。打点API部分提供了C++和JS接口,供开发过程中打点使用,打点是产生Trace数据流,是Trace的基础条件。命令行工具用于采集Trace数据,用来抓取
t
race数据流并保存到文本文件。Trace数据分析可以在图形工具中人工分析,也可以使用分析脚本自动化分析,Trace分析工具以Trace命令行工具的采集结果数据文件为输入。
其中,前两者运行在设备端侧,图形工具运行在PC主机侧。打点API部分提供了C++和JS接口,供开发过程中打点使用,打点是产生Trace数据流,是Trace的基础条件。命令行工具用于采集Trace数据,用来抓取
T
race数据流并保存到文本文件。Trace数据分析可以在图形工具中人工分析,也可以使用分析脚本自动化分析,Trace分析工具以Trace命令行工具的采集结果数据文件为输入。
HiTraceMeter跟踪数据使用类别分类,称作Trace Tag或Trace Category,一般一个端侧软件子系统对应一个Tag。该Tag在打点API中以类别Tag参数传入。Trace命令行工具采集跟踪数据时,只采集给定的Tag类别选项指定的跟踪数据。应用程序跟踪数据类别都是属于APP Tag,从而JS接口不需要输入tag参数,内部实现用的是TAG_APP。目前HiTraceMeter支持的预定义的子系统Tag宏定义列表如下(可在hitrace_meter.h中查看):
```
...
...
@@ -77,7 +77,7 @@ HiTraceMeter主要提供抓取用户态和内核态trace数据的命令行工具
## 约束与限制
HiTraceMeter所有功能与接口的实现都依赖于内核提供的ftrace功能,ftrace 是内核提供的一个 framework,采用 plugin 的方式支持开发人员添加更多种类的 trace 功能,因此使用HiTraceMeter之前要使能 ftrace,否则HiTraceMeter的功能无法使用(目前大部分Linux内核默认使能了ftrace,关于
发
trace的详细介绍可查看内核ftrace相关资料)。
HiTraceMeter所有功能与接口的实现都依赖于内核提供的ftrace功能,ftrace 是内核提供的一个 framework,采用 plugin 的方式支持开发人员添加更多种类的 trace 功能,因此使用HiTraceMeter之前要使能 ftrace,否则HiTraceMeter的功能无法使用(目前大部分Linux内核默认使能了ftrace,关于
f
trace的详细介绍可查看内核ftrace相关资料)。
...
...
@@ -95,7 +95,7 @@ HiTraceMeter分为JS/C++应用打点API与数据采集命令行工具hitrace,
### 接口说明
C++接口仅系统开发者使用,JS(目前暂未开放js接口)应用开发者可以略过本节。L2上接口描述如下(hitrace.h):
C++接口仅系统开发者使用,JS(目前暂未开放js接口)应用开发者可以略过本节。L2上接口描述如下(hitrace
_meter
.h):
**表 1**
同步接口
...
...
@@ -122,11 +122,11 @@ C++接口仅系统开发者使用,JS(目前暂未开放js接口)应用开
异步接口StartAsyncTrace和FinishAsyncTrace的跟踪数据匹配时,使用参数中的value和taskId配对匹配,可以不按顺序使用,主要用于异步场景。在C++程序中,使用异步跟踪的场景很少。
接口中参数解释如下:
-
(1)label:
t
race category;
-
(1)label:
T
race category;
-
(2)name: Trace的名称,IDE中会以此字段展示这段Trace;
-
(3)value: Trace携带的信息,表明当前的某种状态,例如内存大小,队列长短等;
-
(4)taskId:异步Trace中用来表示关联的ID。同步
trace是不需要这个值的,因为同步trace是栈结构,很容易判断trace的起始关联关系,但是异步t
race需要一个ID来表示这个关系;
-
(5)在抓取Trace数据的时候,可以使用hitrace -l命令来检查当前系统中存在的
t
race category,只输出指定tag的数据。
-
(4)taskId:异步Trace中用来表示关联的ID。同步
Trace是不需要这个值的,因为同步Trace是栈结构,很容易判断Trace的起始关联关系,但是异步T
race需要一个ID来表示这个关系;
-
(5)在抓取Trace数据的时候,可以使用hitrace -l命令来检查当前系统中存在的
T
race category,只输出指定tag的数据。
### 开发流程
...
...
@@ -178,7 +178,7 @@ external_deps = [ "hitrace_native:hitrace_meter"]
}
打点编译部署完成后,运行下面命令行来抓取
t
race。然后在端侧shell里运行应用,可以抓取到Trace数据。
打点编译部署完成后,运行下面命令行来抓取
T
race。然后在端侧shell里运行应用,可以抓取到Trace数据。
hdc_std shell hitrace -t 10 ohos > .
\m
yapp_demo.ftrace
抓取之后的数据可以在smartperf中"Open trace file"或者直接拖入图形区打开。
...
...
@@ -298,32 +298,32 @@ HiTraceMeter提供了可执行的二进制程序hitrace用于抓取内核运行
-
设置4M缓存,抓取10秒,抓取label为ability的trace信息。
```
hitrace -b 4096 -t 10 --overwrite ability > /data/mytrace.ftrace
hitrace -b 4096 -t 10 --overwrite ability > /data/
log/
mytrace.ftrace
```
-
设置trace的输出时钟为mono。
```
hitrace --trace_clock mono -b 4096 -t 10 --overwrite ability > /data/mytrace.ftrace
hitrace --trace_clock mono -b 4096 -t 10 --overwrite ability > /data/
log/
mytrace.ftrace
```
-
抓取trace后进行压缩。
```
hitrace -z -b 4096 -t 10 --overwrite ability > /data/mytrace.ftrace
hitrace -z -b 4096 -t 10 --overwrite ability > /data/
log/
mytrace.ftrace
```
# 常见问题
### trace抓数据不全或者没抓到数据
###
hi
trace抓数据不全或者没抓到数据
#### 现象描述
执行trace命令抓数据不全或者没抓到数据
执行
hi
trace命令抓数据不全或者没抓到数据
#### 解决方法
...
...
@@ -333,5 +333,5 @@ HiTraceMeter提供了可执行的二进制程序hitrace用于抓取内核运行
# 参考
更多关于hitrace的详细内容请参考:
[
hiviewdfx_hitrace: A Lightweight Distributed Tracing | 轻量级的分布式调用链跟踪 (gitee.com)
](
https://gitee.com/openharmony/hiviewdfx_hitrace
)
更多关于hitrace
_meter
的详细内容请参考:
[
hiviewdfx_hitrace: A Lightweight Distributed Tracing | 轻量级的分布式调用链跟踪 (gitee.com)
](
https://gitee.com/openharmony/hiviewdfx_hitrace
)
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录