ez_monitor

ez_monitor is a lightweight web application that provides real-time system metrics visualization for your machine. It displays CPU, memory, disk, GPU, disk I/O, and network usage in an easy-to-read dashboard.

Installation

pip install git+https://github.com/pedro-cf/ez_monitor.git

Usage

After installation, you can run ez_monitor directly from the command line:

ez_monitor

By default, ez_monitor will start on port 5000. You can access the dashboard by opening a web browser and navigating to http://localhost:5000/.

Command-line Arguments

You can customize the behavior of ez_monitor using the following command-line arguments:

• --host: Specify the host to run the server on (default: 127.0.0.1, use 0.0.0.0 for network access)
• -p, --port: Specify the port to run the server on (default: 5000)
• -r, --refresh-rate: Set the refresh rate in seconds (default: 2)
• -m, --max-data-points: Set the maximum number of data points to keep (default: 1800)
• --debug: Run the application in debug mode

Example:

ez_monitor -p 8080 -r 1.5 -m 3600 --debug

This will run ez_monitor on port 8080, with a refresh rate of 1.5 seconds, keep up to 3600 data points, and run in debug mode.

Features

• Real-time system metrics visualization
• Web-based interface for easy access
• Displays CPU, memory, disk, GPU, disk I/O, and network usage
• Interactive charts for historical data
• Customizable disk selection for multi-disk systems
• Configurable refresh rate and data retention
• Top processes monitoring: View a list of the top processes consuming system resources, including CPU usage, memory usage, and process status
• Docker container monitoring: If Docker is available on your system, ez_monitor displays information about running containers, including resource usage and status
• Customizable dashboard layout with adjustable columns and scaling
• Ability to show/hide individual metrics and components
• Settings modal for easy configuration of display options
• Scalable interface: Use the scale slider in the settings to resize the entire dashboard, making it easier to fit on different screen sizes
• Persistent settings: Your layout and display preferences are saved and persisted between sessions

Requirements

ez_monitor requires Python 3.7 or higher. All other dependencies will be automatically installed when you install ez_monitor using pip.

License

ez_monitor is released under the MIT License. See the LICENSE file for details.

Support

If you find this project useful, consider buying me a coffee! Donations help keep this project going and are greatly appreciated.