OpenHarmony火焰图生成流程(hiperf)
前言
OpenHarmony目前还处于刚起步,一些用于分析性能的工具还比较少。
一、hiperf是什么?
hiperf 是 OpenHarmony 为开发人员提供的用于调试的命令行工具,用于抓取特定程序或者系统的性能数据,类似内核的 perf 工具,该工具支持在 Windows/Linux/Mac 等操作系统上运行。
二、使用步骤
1.环境
1.Python 3.7.0
2.安装好SDK,(开发者可通过DevEco Studio的SDK Manager下载、更新HarmonyOS SDK,也可以通过Command Line Tools来管理HarmonyOS SDK)
3.刷机(rk3568)
4.编译好的源码,在编译完成后
运行 developtools/hiperf/script/package.sh 打包到out文件夹中
host/
└── developtools
├── hiperf
│ ├── bin # 所有的二进制文件
│ │ ├── linux # linux 平台
│ │ │ └── x86_64
│ │ │ ├── hiperf_host # PC运行的执行程序,支持Report和Dump命令
│ │ │ └── libhiperf_report.so # PC运行的LIB文件,供python脚本使用
│ │ ├── ohos
│ │ │ └── arm # arm 平台
│ │ │ └── hiperf # 板端执行程序
│ │ └── windows # windows 平台
│ │ └── x86_64
│ │ ├── hiperf_host.exe # PC运行的执行程序
│ │ └── libhiperf_report.dll # PC运行的LIB文件
│ │
│ │ # 下面都是python文件,在PC侧执行
│ ├── command_script.py # hiperf 命令行的包装脚本,产生采样数据
│ ├── hiperf_utils.py # 脚本自己的工具类
│ ├── loadlib_test.py # lib 测试脚本
│ ├── make_diff.py # 产生Diff数据的脚本
│ ├── make_report.py # 从采样数据产生报告的脚本
│ ├── recv_binary_cache.py # 收集符号表的脚本
│ └── report.html # HTML 展示页面的模板
└── hiperf.tar.gz # 上述文件的打包文件
带调试符号的版本
在对应的平台out里面找 exe.unstripped 和 lib.unstripped,例如:
out\ohos-arm-release\clang_x64\exe.unstripped\clang_x64\developtools\hiperf
2.用脚本采样
脚本
一般用户用脚本执行采样操作(因为可以简单的产生HTML报告)
采样
由 command_script.py 完成,他是report命令的包装脚本
usage: command_script.py [-h]
(-app PACKAGE_NAME | -lp LOCAL_PROGRAM | -cmd CMD | -p [PID [PID ...]] | -t [TID [TID ...]] | -sw)
[-a ABILITY] [-r RECORD_OPTIONS] [-lib LOCAL_LIB_DIR]
[-o OUTPUT_PERF_DATA] [--not_hdc_root]
Collect performance sampling information of running [command].
对指定包名采样,包名是 ohos.samples.ecg
python command_script.py -app ohos.samples.ecg(参考指令)
对特定进程采样,进程名称是
python command_script.py -lp hdcd(参考指令)
收集符号表
由 recv_binary_cache.py 完成,他主要根据 perf.data 里面记录的相关文件和库,以及它们的 buildid 在用户指定的路径中去寻找对应的 ELF 作为符号表文件用于回栈或者打印函数名等。
usage: recv_binary_cache.py [-h] [-i PERF_DATA]
[-l LOCAL_LIB_DIR [LOCAL_LIB_DIR ...]]
Recv binaries needed by perf.data from device to binary_cache directory.
python recv_binary_cache.py -l Z:\OHOS_MASTER\out\ohos-arm-release\lib.unstripped Z:\OHOS_MASTER\out\ohos-arm-release\exe.unstripped(参考指令)
对应的符号表文件(lib.unstripped、exe.unstripped)会复制到 binary_cache 文件夹里面
展示
由指令make_report.py 完成,将采样后的数据导出为HTML展示页面
usage: make_report.py [-h] [-i PERF_DATA] [-r REPORT_HTML]
产生HTML文件,默认的文件名是 hiperf_report.html
python make_report.py(参考指令)
展示页面首页
展示页面火焰图
总结
OpenHarmony中还有几种抓trace的方法后续文章继续分享。