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（参考指令）

展示页面首页

image.png

展示页面火焰图

image.png

总结

OpenHarmony中还有几种抓trace的方法后续文章继续分享。