System Health Monitor-Shell Script Automation

System Health Monitor is a lightweight full-stack project that collects and displays system performance data using a Bash script integrated with a simple web interface. It helps users quickly check system health including CPU usage, memory, disk space, uptime, and running processes

---

🚀 Features:

📊 System Health Report – Generates real-time system status 💾 Disk Usage Monitoring – Displays storage usage 🧠 Memory Usage Tracking – Shows RAM usage ⏱️ Uptime Monitoring – Tracks system running time ⚙️ Process List – Displays active processes 🌐 Web Interface – View report via browser 🔁 Automation Ready – Can be scheduled for periodic execution

📦 Prerequisites

Ensure the following are installed:

• Python 3.x
• Flask
• Bash / Git Bash (Windows)
• Web Browser

---

🛠️ Technologies Used

Frontend:

• HTML5
• CSS3
• JavaScript

Backend:

• Python (Flask)
• Bash Shell Script

Tools:

• VS Code
• Git & GitHub
• Git Bash / Linux Terminal

---

📁 Project Structure

system-health-monitor/

├── backend/

│ ├── app.py │ └── ps-health-report.sh

├── frontend/

│ ├── index.html │ └── script.js

├── logs/

│ └── ps-health-report.txt

├── README.md

---

⚙️ Installation

1️⃣ Clone the repository

• git clone https://github.com/your-username/system-health-monitor.git
• cd system-health-monitor

2️⃣ Start Backend Server

• cd backend
• pip install flask
• python app.py

3️⃣ Run Frontend

Open in browser:

frontend/index.html

▶️ How It Works

• User clicks Run Report on UI

• Flask backend triggers the Bash script

• Script collects system data using Linux commands

• Data is saved in a log file

• Frontend fetches and displays the report

---

Workflow Diagram

---

📌 Example Use Cases

• Monitoring system performance
• Learning shell scripting & automation
• Beginner DevOps practice
• Academic mini-project

---

🚀 Future Enhancements

• Real-time CPU graphs
• User authentication
• Cloud deployment
• Docker support
• Alert notifications

---

📄 License

This project is for educational purposes. Free to use with attribution.

---

🙌 Acknowledgments

• Open-source community
• Linux documentation
• Academic guidance

---

🔗 Repository Clone

gh repo clone tfregixx/-System-Health-Monitor-Shell-Script-Automation