perfVisual - 程序性能监控与可视化工具

一个用于监控指定进程系统资源使用情况的Python工具，可生成结构化数据用于分析。

功能特性

• 实时监控并记录进程资源使用数据到SQLite数据库
• 支持自定义监控间隔（毫秒级精度）
• 提供命令行界面和程序API两种使用方式
• 生成可直接导入分析工具的结构化数据
• 内置数据可视化功能（通过visual.html）
• 监控指标包括：
  • CPU使用率
  • 内存占用
  • 磁盘I/O速度
  • 线程数量

可视化示例

项目结构

.
├── perfvisual/              # 核心功能模块
│   ├── perfvisual.py        # 主监控程序
│   └── embedding.py         # 辅助功能模块
├── visual.html              # 数据可视化界面
├── dbFormat.md              # 数据库结构文档
├── LICENSE                  # 许可证文件
└── README.md                # 项目说明文档

安装要求

• Python 3.6+
• 依赖库：
  • psutil
  • sqlite3 (Python内置)

安装依赖：

pip install psutil

使用说明

基本用法

./perfvisual.py "python3 my_script.py" > stats.csv

带参数用法

./perfvisual.py --interval 500 "java -jar myapp.jar" | tee log.txt

可视化数据

1. 运行监控程序生成数据文件
2. 打开visual.html加载数据文件
3. 交互式查看资源使用曲线

数据库嵌入HTML

将监控生成的SQLite数据库嵌入到HTML可视化文件中：

./perfvisual/embedding.py visual.html performance.db

参数说明：

• visual.html: 原始可视化HTML模板文件
• performance.db: 监控生成的SQLite数据库文件

输出：

• database_visual.html: 输出文件（自动生成带数据库前缀）

参数说明

参数	描述
<执行命令>	需要监控的命令及其参数（需用引号包裹）
-i, --interval	监控间隔（毫秒，默认100ms），建议范围：100-5000

输出说明

• 标准输出包含TSV格式的实时监控数据
• 同时会写入SQLite数据库（默认按时间生成文件名）
• 数据库包含完整监控指标，包括：
  • 时间戳
  • 线程数
  • CPU百分比
  • 内存占用(MB)
  • 读/写操作次数
  • 读/写字节数
  • 读/写速率(MB/s)

典型使用场景

1. 性能基准测试
2. 资源泄漏检测
3. 程序行为分析

开发API

基本监控

from perfvisual import PerfVisual

# 初始化监控器
pv = PerfVisual(intervalMs=500)  # 500ms采样间隔

# 执行监控
pv.exec("python3 my_script.py", recordDB="performance.db")

高级用法

# 自定义回调处理监控数据
def on_sample(data):
    print(f"CPU: {data['cpu_percent']}%")

pv = PerfVisual(intervalMs=200)
pv.set_callback(on_sample)
pv.exec("node server.js")

数据库结构

详细数据库格式请参考dbFormat.md

问题反馈

遇到问题请提交至：Issues页面

许可证

本项目采用 MIT License