性能采集工具 SoloX 定制化(Windows + 车机实战)
这篇博客以性能采集工具 SoloX 为案例,讲解如何在 Windows 电脑 + 车机的实际环境下,使用并定制开发一款性能采集工具:解决 CPU、网络、FPS 采集的兼容性问题,新增任意进程 PID 监控、设备整体内存曲线,并把 CPU 百分比改为按设备核数动态换算。文末附完整操作指引。
官方网站
https://pepy.tech/projects/solox?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=weekly&viewType=line&versions=Total%2C2.*%2C1.*
1. 需求来源
项目性能优化专项测试中需要长期采集 CPU 占用、内存占用、FPS、网络流量等指标。性能优化不仅仅要看系统整体资源情况,还需要单独看占用大头应用的资源情况。经常用命令和脚本跑出来的数据不直观、也不方便留存对比。
所以我选用了开源性能采集工具 SoloX:它提供网页端采集与报告,跑在本地,页面可以选定应用和进程,实时监控该进程的 CPU 占用、内存及其他资源的使用情况。
2. 工具概述
SoloX 是一个开源的 Android 性能测试数据采集工具:PC 上启动一个本地网页服务,车机通过 adb 连接后,在网页中实时查看 CPU、内存、FPS 等曲线,停止监控后自动生成带图表的 HTML 报告。
采集实现方式:没有常驻采集进程,前端每秒 AJAX 请求一次查询接口,每次请求现场构造 CPU / MEM 对象 → 通过 adb shell 读取 /proc/<pid>/stat、dumpsys meminfo 等 → 解析计算 → 写入纯文本日志。
功能清单:CPU、内存、FPS、GPU、电量、温度、网络流量、磁盘等实时监控;还有设备信息、录屏、指标告警阈值、采集时长自动停止、停止后生成静态图表、xls 导出等。
特点:因为其开源的性质,源码都在安装目录下,可以根据项目需求进行定制化处理。
本次新增:
- 任意进程 PID 监控:不选 APP,直接监控 system_server 等原生进程的 CPU / 内存 / 网络;
- 设备整体内存曲线:实时页 / 报告页 / 分析页三处同步呈现;
- CPU 曲线按设备核数动态换算:1 核满载 = 100%,6 核满载 = 600%、8 核 = 800%(自动识别设备核数)。
3. 功能新增与实现
3.1 任意进程 PID 监控
新增 /device/processes 接口(ps -ef 全量进程列表,主进程排在前面),页面在 APP 选择框下新增进程下拉框(支持搜索),选中后自动注入原有进程选择器。后端 CPU / 内存 / 网络模块本就支持按 pid 直传,因此对任意原生进程生效;FPS 依赖应用图形窗口,选原生进程时自动跳过,避免无效轮询。
原版只能测应用的 CPU、内存情况,增加任意进程选择后,大大提高了这个项目的实用性、可复用性和适配性。
查看 system_server 进程监控效果如图:
3.2 设备整体内存
新增 getDeviceMemory() 读取 /proc/meminfo(总量 − MemAvailable),采集时同步写入 mem_device.log;实时页新增独立勾选项「设备整体内存」(含 device used 曲线与总量参考线),报告模板与「分析」页同步新增 Device Memory 卡片。
效果如图:
3.3 CPU 动态核数百分比
原版 CPU 总占用固定按 100% 计算,多核设备的真实负载会被"摊薄"。修改后 CPU 曲线按"识别设备有几个核,满载就几百%":核数检测读取 /sys/devices/system/cpu/online,支持 0-5、0、0-3,6-7 等热插拔区间格式;6 核车机满载 600%,8 核设备 800%。应用占用与系统占用(total)两条曲线口径统一。
效果如图:
4. 打包与分发
原版需要pip下载,下载依赖包,笔者修改后提供离线整合包交付:Python 3.11.9 嵌入版 + 全部 37 个依赖 + adb + 启动 bat,约 100MB,解压双击 start_solox.bat 即用,无需安装 Python、无需联网。
5. 实现效果与操作指引
工具采集页支持 CPU、内存、内存细化指标、设备整体内存、FPS/Jank、电池、网络、磁盘等曲线;CPU 曲线支持按设备核数的多核口径展示。采集结束自动生成带图表的报告,分析页可逐指标查看并截图导出。
连接 adb 后自动连接,选项中会自动识别所有包名:
选择已打开的应用,开始采集后效果:
停止后自动生成报告:
报告会保存在本地的 report 目录(抓取的数据与录屏都会保存在此处):
使用步骤
- 解压/安装后双击
start_solox.bat,自动打开浏览器;
-
页面点「连接」→ 选择车机设备;
-
选择 APP,或在新增的「选择任意进程PID」下拉框直接选目标进程(无需选 APP);
-
勾选 CPU、内存、设备整体内存、FPS 等指标,点开始采集,操作被测应用;
-
点停止生成报告,report 目录生成带图表的 report.html;
-
在报告列表点「分析」逐指标查看图表,内存区新增设备整体内存卡片,可截图导出。
6. 优势
- 功能齐全:数据实时可视化,一目了然,操作简洁方便,不需要配置环境,连接 adb 即可操作。
- 通用性:实际测试两个不同平台、不同 Android 版本的车机,都能正常使用。
- 可定制化:由于其开源性质,源码基本用 Python 语言编写,大大提高了可修改、可定制的可能。大的框架已经有了,可以根据项目需求的不同,在其框架基础上定制各种可视化曲线。例如:在内存曲线中再增加更详细的内存使用情况;增加定制化曲线,监控设备某个节点的实时情况,等等。
结语
从"命令行跑脚本看数字"到"网页实时曲线 + 一键报告",性能问题的定位效率完全不一样。SoloX 的开源属性让它非常适合按项目需求做二次开发——遇到不兼容的环境,把问题拆开逐个击破,再把成果打包成开箱即用的工具,需要的可以私信我。