# HiDumper组件 - [HiDumper组件](#hidumper组件) - [简介](#简介) - [目录](#目录) - [说明](#说明) - [接口说明](#接口说明) - [使用说明](#使用说明) - [相关仓](#相关仓) ## 简介 HiDumper是OpenHarmony中为开发、测试人员，IDE工具提供统一的系统信息获取工具，帮助使用者分析，定位问题。 HiDumper主要包括以下几个主要模块： - hidumper，hidumper工具的可执行程序，接收用户输入，与服务端通讯。 - DumpManager，系统信息导出工具管理者，提供信息分类，命令请求分发和信息获取方法的管理。 - Dumpers，各类信息的导出器。主要包括文件导出、命令导出、CPU使用导出、内存使用导出等。 - Output，内容输出，主要包括向标准输出或文件输出的FdOutput，压缩输出的ZipOutput。 **图1** HiDumper架构图 ![](figures/zh-cn_image_0000001116226343.png) ## 目录 ``` /base/hiviewdfx/hidumper ├── client # 客户端代码 │ ├── native # 客户端native代码 ├── frameworks # 框架代码 │ ├── native # 导出功能核心代码 | | |── include # 头文件目录 | | |── src # 源文件目录 | | |── common # 通用功能代码 | | |── executor # 导出过程执行器代码 | | |── factory # 跟进导出项生成导出执行器 | | |── manager # 导出管理核心代码 | | |── util # 工具类源代码 |── sa_profile # Hidumper sa 属性文件 |── services # Hidumper服务源码 | |── native # 服务C++源码 | |── zidl # 通讯功能源码目录 | | |── include # 通讯功能头文件 | | |── src # 通讯功能源代码 ├── test # 测试用例目录 │ ├── unittest # 单元测试代码 │ ├── moduletest # 模块级别测试代码 ``` ## 说明 开发者在OpenHarmony应用开发过程中需要查询系统信息，服务信息，进程栈等信息时可以通过HiDumper获取到对应信息，然后利用这些信息分析定位问题。 ### 使用说明 hidumper可以为开发者导出系统当前基本信息，通过这些基本信息可以定位分析问题。给子服务和元能力传递复杂参数时，参数需要在双引号中。 具体步骤如下： 1. 进入设备命令行，输入hidumper -h获取基本信息介绍，功能语法介绍。 ``` hidumper -h ``` 2. 输入hidumper -lc获取系统信息分类列表。 ``` hidumper -lc ``` 3. 输入hidumper -c 获取系统base、system等所有分类信息。 ``` hidumper -c ``` 4. 输入 **hidumper -c [base system]** 按 **base** 或 **system** 分类获取系统簇信息。 ``` hidumper -c base hidumper -c system ``` 5. 输入 **hidumper -ls** 命令获取系统中元能力列表。 ``` hidumper -ls ``` 6. 输入 **hidumper -s** 命令获取系统全部元能力信息。 ``` hidumper -s ``` 7. 运行 **hidumper -s 3301 -a "-h"** 命令获取id为3301的元能力的帮助。 ``` hidumper -s 3301 -a "-h" ``` 8. 运行 **hidumper -s 3008** 命令获取id为3008的元能力的全部信息。 ``` hidumper -s 3008 ``` 9. 运行 **hidumper -e** 命令获取Faultlog模块生成的崩溃历史信息。 ``` hidumper -e ``` 10. 运行 **hidumper --net [pid]** 命令获取网络信息；如果指定了进程的pid，则只获取该进程的网络流量使用信息。 ``` hidumper --net hidumper --net 1024 ``` 11. 运行 **hidumper --storage [pid]** 命令获取存储相关信息；如果指定了进程的pid，则只获取该进程的io信息。 ``` hidumper --storage hidumper --storage 1024 ``` 12. 运行 **hidumper -p** 命令获取进程信息，包括进程、线程的列表和信息。 ``` hidumper -p ``` 13. 运行 **hidumper -p 1024** 命令获取pid为1024的进程信息。 ``` hidumper -p 1024 ``` 14. 运行 **hidumper --cpuusage [pid]** 命令获取CPU的使用信息；如果指定了进程的pid，则只获取该进程的CPU使用信息。 ``` hidumper --cpuusage hidumper --cpuusage 1024 ``` 15. 运行 **hidumper --cpufreq** 命令获取每一个CPU核实际运行的频率。 ``` hidumper --cpufreq ``` 16. 运行 **hidumper --mem [pid]** 命令获取全部的内存使用信息；如果指定进程的pid，只获取该进程的内存使用情况。 ``` hidumper --mem hidumper --mem 1024 ``` 17. 运行 **hidumper --zip** 命令压缩信息数据到/data/log/hidumper目录下。 ``` hidumper --zip ``` 18. 运行 **hidumper --mem-smaps pid [-v]** pid 必选参数。命令获取指定进程内存信息的详细使用情况。 ``` hidumper --mem-smaps pid [-v] ``` 19. 运行 **hidumper --mem-jsheap pid [-T tid] [--gc]** pid 必选参数。命令触发所有线程gc和快照导出。如果指定线程的tid，只触发该线程gc和快照导出；如果指定--gc，只触发gc不做快照导出。 ``` hidumper --mem-jsheap pid [-T tid] [--gc] ``` ## 相关仓 [DFX子系统](https://gitee.com/openharmony/docs/blob/master/zh-cn/readme/DFX子系统.md) [hiviewdfx_hilog](https://gitee.com/openharmony/hiviewdfx_hilog/blob/master/README_zh.md) [hiviewdfx_faultloggerd](https://gitee.com/openharmony/hiviewdfx_faultloggerd/blob/master/README_zh.md) [hiviewdfx_hidumper](https://gitee.com/openharmony/hiviewdfx_hidumper/blob/master/README_zh.md)