Skip to content

Abhinavu-T-Rajan/LoadWatcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🖥️ LoadWatcher

LoadWatcher is a lightweight Python-based system resource monitoring tool that sends webhook alerts when your Linux system is under heavy load.

Useful for servers, homelabs, or pentest boxes that need to notify you (via Discord, Slack, or custom webhooks) when things go wrong.


🚀 Features

  • ✅ Monitors CPU, RAM, and Disk usage
  • 📡 Sends webhook alerts when thresholds are exceeded
  • 🪶 Runs as a minimal systemd service
  • ⚙️ Customizable thresholds and alerting
  • 🐧 Built for Linux systems

📦 Requirements

  • Python 3
  • psutil and requests libraries

Install with:

sudo apt install python3 python3-pip
pip3 install psutil requests

Setup Guide

1. Clone the Repository

git clone https://github.com/Abhinavu-T-Rajan/LoadWatcher.git
cd LoadWatcher

2. Configure your webhook

nano loadwatcher.py
WEBHOOK_URL = "https://your-webhook-url-here"

Make it executable

chmod +x loadwatcher.py

(Optional) Move to a global path:

sudo cp loadwatcher.py /usr/local/bin/loadwatcher

Create a systemd service

sudo nano /etc/systemd/system/loadwatcher.service

then

[Unit]
Description=LoadWatcher - System Resource Webhook Monitor
After=network.target

[Service]
ExecStart=/usr/bin/python3 /usr/local/bin/loadwatcher
Restart=always
User=root

[Install]
WantedBy=multi-user.target

Enable & start

sudo systemctl daemon-reload
sudo systemctl enable loadwatcher
sudo systemctl start loadwatcher

Check status

sudo systemctl status loadwatcher

About

Watches your system load and warns you.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages