❤️ HealthPulse — Linux System Health Monitoring & Reporting Tool

HealthPulse is a lightweight Bash-based system monitoring utility that helps Linux administrators monitor the overall health of their servers by tracking CPU usage, memory utilization, disk usage, uptime, and system load.

Designed as a practical Linux administration project, HealthPulse demonstrates Bash scripting, automation, resource monitoring, logging, and proactive system maintenance.

---

✨ Features

• ❤️ Monitors CPU utilization
• 🧠 Tracks memory usage
• 💽 Checks disk usage against configurable thresholds
• 📈 Reports system uptime and load averages
• 📝 Generates timestamped log files
• 🚨 Produces alerts when resource usage exceeds defined limits
• ⏰ Supports scheduled execution with cron
• 🐧 Lightweight and compatible with most Linux distributions

---

📂 Project Structure

HealthPulse/
├── health-monitor.sh
├── logs/
└── README.md

---

🚀 Installation

Clone the repository:

git clone https://github.com/Kachinonye/HealthPulse.git

Navigate to the project directory:

cd HealthPulse

Make the script executable:

chmod +x health-monitor.sh

---

▶️ Usage

Run the monitoring script manually:

./health-monitor.sh

Or schedule automatic execution using cron:

*/10 * * * * /path/to/health-monitor.sh

This example runs HealthPulse every 10 minutes.

---

📄 Log Output

HealthPulse records monitoring results in timestamped log files, making it easy to review historical system health, identify trends, and troubleshoot performance issues.

Example information collected:

• CPU usage
• Memory usage
• Disk usage
• System uptime
• Load average
• Alert status

---

💼 Skills Demonstrated

This project demonstrates practical experience with:

• Linux System Administration
• Bash Shell Scripting
• Performance Monitoring
• Resource Monitoring
• Automation
• Log Management
• Cron Scheduling
• System Diagnostics
• Technical Documentation

---

🎯 Use Cases

HealthPulse is ideal for:

• Linux System Administrators
• Junior DevOps Engineers
• Cloud Server Monitoring
• Home Lab Environments
• Small Business Servers
• Students learning Linux administration

---

🔮 Planned Enhancements

Future versions may include:

• Email alert notifications
• HTML health reports
• JSON output for integrations
• Configurable threshold file
• Multi-server monitoring
• Slack and Discord notifications
• Historical trend reporting
• Colourized terminal dashboard

---

👨‍💻 Author

Kachinonye Nmezi

Junior Linux Administrator | Bash Scripting & Automation Specialist

GitHub: https://github.com/Kachinonye

LinkedIn: https://www.linkedin.com/in/kachinonye-nmezi-74170723b/

---

📜 License

Licensed under the MIT License.