# performance_monitor

**Repository Path**: zhang_hui_yu1992/performance_monitor

## Basic Information

- **Project Name**: performance_monitor
- **Description**: psutil based performance testing tool for windows and linux

Can monitor [' CPU percentage ', 'has been in memory/MB', 'read disk MB/s',' the disk write MB/s', 'network upload MB/s',' Internet downloa
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2023-04-19
- **Last Updated**: 2023-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[中文文档](https://github.com/Franciz008/performance_monitor/blob/main/中文ReadMe.md)

# Software Process Monitoring Tool

## Description

This is a command-line tool used to monitor the processes (including subprocesses) of specified software, or to record system performance information. You can choose to monitor the processes of a specific software, or record system performance information, or both.

## Options

- `-s, --system`: The default option, used to record system performance information.
- `-p, --process`: Specifies the name of the software to be monitored.
- `-port`: Specifies the port number of the monitored software.
- `-it, --interval_time`: Specifies the time interval for recording system performance information, default is 10 seconds.
- `-fp, --file_period`: Specifies the data period to be recorded, default is 7 days.
- `-d, --detail`: Specifies whether to record the process list to a CSV file, default is not recorded.

The options "-s" and "-p" are mutually exclusive and cannot be used simultaneously.

## Windows Usage

### Monitor the process of the software

```bash
monitx.exe -p <software_name> -port <port_number>
```

### Record system performance information

```bash
monitx.exe -s
```

### Monitor the process of the software and record system performance information at the same time

```bash
monitx.exe -p <software_name> -port <port_number> -it <interval_time> -fp <file_period> -d
```

## Linux Usage

### Monitor the process of the software

```bash
monitx -p <software_name> -port <port_number>
```

### Record system performance information

```bash
monitx -s
```

### Monitor the process of the software and record system performance information at the same time

```bash
monitx -p <software_name> -port <port_number> -it <interval_time> -fp <file_period> -d
```

**Monitor the performance information of all processes that contain the process name "frp" every 2 seconds.**

```
monitx -p frp -it 2
```