# performance_monitor

**Repository Path**: FrancizTest_admin/performance_monitor

## Basic Information

- **Project Name**: performance_monitor
- **Description**: 这是一个基于 psutil 的跨平台性能监控工具，支持 Windows 与 Linux 系统，支持监控进程。
该工具能够实时监测并展示以下关键性能指标：
CPU 使用率（百分比）内存占用情况（MB）磁盘读速率（MB/s）磁盘写速率（MB/s）网络上传速率（MB/s）
网络下载速率（MB/s）
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 2
- **Created**: 2023-03-01
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# monitx

基于psutil开发的Windows和Linux性能测试工具

可以监控操作系统的 ["cpu %/s", "used mem %", "disk read MB/s", "disk write MB/s", "net upload MB/s", "net download MB/s"]
可以监控软件的 ["date", "time", "cpu %/s", "used mem%", "io_input MB/s", "io_output MB/s"]

## 简介

软件资源占用非常小几乎可以忽略不计,记录的数据是实时写入的--即使关闭了程序,历史记录也存在.

启动软件默认10s记录`系统性能`并写入一次`当前系统日期_MonitorInfo.csv` 文件存在于软件所在目录

## 使用说明：

该脚本用于记录系统性能信息或监控指定软件的进程状态。可以选择记录系统性能信息或者指定软件的性能信息。
建议优先使用记录系统性能信息,并且设置监控的时间间隔大于等于5秒。

## 参数解释：

- 监控系统性能信息：
  - `-s` 或 `--system`：记录当前系统性能信息。这是默认选项。
  - `-n` 或 `--name`：指定生成的文件名，默认根据当前日期命名。
  - `-it` 或 `--interval_time`：设置记录间隔时间，默认为10秒/次，建议大于等于5秒/次。
  - `-fp` 或 `--file_period`：设置记录周期，默认为7天/次。
- 监控指定软件进程（包括子进程）：
  - `-p` 或 `--process`：指定软件名称，记录该软件对应的性能信息。
  - `-port`：指定软件的端口号。
  - `-n` 或 `--name`：指定生成的文件名，默认根据当前日期命名。
  - `-it` 或 `--interval_time`：设置记录间隔时间，默认为10秒/次，建议大于等于5秒/次。
  - `-fp` 或 `--file_period`：设置记录周期，默认为7天/次。

其他选项：

- `-oh` 或 `--open_html`：根据给定的监控文件路径、起始时间和时间间隔生成并打开 HTML 性能图表。例如：`-oh D:\\test\\xxx.csv 17:10 5` 表示生成并打开 `xxx.csv` 中从 17:10 之后的 5 分钟内的性能图表。
- `-ohf` 或 `--open_full_time_range_html`：生成并打开给定监控文件的全时段的 HTML 性能图表。例如：`-ohf D:\\test\\xxx.csv` 表示生成并打开 `xxx.csv` 的全时段性能图表。

## 示例：

#### 监控系统性能信息：

```
monitx.exe
```

或者

```
monitx.exe -s
```

- 这将记录当前系统的性能信息，并使用默认选项保存到文件中。

```
monitx.exe -n performance_info
```

- 这将记录当前系统的性能信息，并将结果保存到名为 `performance_info` 的文件中。

```
monitx.exe -it 5 -fp 3
```

- 这将以每5秒记录一次性能信息，并将结果保存到每3天生成一次的文件中。

#### 监控指定软件进程（包括子进程）：

```
monitx.exe -p edge -port 8083
```

- 这将监控名为 `edge` 的软件进程，并记录其对应的性能信息。使用默认选项将结果保存到文件中。

```
monitx.exe -p app -port 8081 -n process_info
```

- 这将监控名为 `app` 的软件进程，并记录其对应的性能信息。将结果保存到名为 `process_info` 的文件中。

```
monitx.exe -p chrome -port 8000 -it 10 -fp 7
```

- 这将监控名为 `chrome` 的软件进程，并以每10秒记录一次性能信息。将结果保存到每7天生成一次的文件中。

#### 其他选项：

```
monitx.exe -oh D:\\test\\xxx.csv 17:10 5
```


## Linux Help
```shell
rpm -ivh --force monitx-<版本号>.rpm
```