Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marwan-ahmed-23/linux-system-health-monitor
A lightweight Shell script for monitoring Linux system performance, including CPU, memory, disk, network, and processes.
https://github.com/marwan-ahmed-23/linux-system-health-monitor
bash linux monitoring shell-script system-performance
Last synced: 19 days ago
JSON representation
A lightweight Shell script for monitoring Linux system performance, including CPU, memory, disk, network, and processes.
- Host: GitHub
- URL: https://github.com/marwan-ahmed-23/linux-system-health-monitor
- Owner: marwan-ahmed-23
- License: mit
- Created: 2024-12-21T22:54:39.000Z (25 days ago)
- Default Branch: main
- Last Pushed: 2024-12-21T23:06:00.000Z (25 days ago)
- Last Synced: 2024-12-22T00:17:39.615Z (25 days ago)
- Topics: bash, linux, monitoring, shell-script, system-performance
- Language: Shell
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🛠️ Linux System Health Monitor
## 📖 Description
A **Shell script** that monitors Linux system performance and generates detailed reports on:
- 🖥️ **CPU Usage**
- 🧠 **Memory Usage**
- 💾 **Disk Usage**
- 🌐 **Network Activity**
- 🔍 **Top Processes**
This tool is lightweight, easy to use, and saves reports for later analysis.
---
## ✨ Features
- 🖥️ **CPU Monitoring**: Displays the current CPU usage.
- 🧠 **Memory Monitoring**: Shows memory usage details.
- 💾 **Disk Usage**: Reports disk space usage for the root partition.
- 🌐 **Network Usage**: Monitors download and upload speeds.
- 🔍 **Process Monitoring**: Lists the top 5 processes by CPU and memory usage.
- 📂 **Logging**: Saves daily reports in the `logs/` directory.
---
## 🚀 Usage
1. **Clone the repository**:
```bash
git clone https://github.com/marwan-ahmed-23/linux-system-health-monitor.git
cd linux-system-health-monitor
```
2. **Make the script executable**:
```bash
chmod +x health-monitor.sh
```
3. **Run the script**:
```bash
./health-monitor.sh
```
4. **Check the logs**:
```bash
cat logs/system_report_YYYY-MM-DD.log
```
## 📂 Directory Structure
```plaintext
linux-system-health-monitor/
├── logs/
│ └── system_report_YYYY-MM-DD.log
├── health-monitor.sh
├── README.md
├── LICENSE
└── .gitignore
```
## ⚙️ Requirements
- 🐚 **Bash**
- 🌐 **ifstat** command (install with `sudo apt install ifstat`)
## 🤝 Contributions
Contributions are welcome! Feel free to:
- 🔧 Add more monitoring features.
- 🛠️ Improve the existing functionality.
- 📘 Enhance documentation.
## 🌟 Stay Connected
Feel free to **star** ⭐ this repository if you find it helpful!