Skip to content
This repository has been archived by the owner on Nov 17, 2023. It is now read-only.

Latest commit

 

History

History
25 lines (15 loc) · 1.33 KB

README.md

File metadata and controls

25 lines (15 loc) · 1.33 KB

lightweight-healthcheck

lightweight-healthcheck is a minimal but effective healthchecking/monitoring script.

  • written in Bash & deployable on Linux or macOS
  • email & SMS (via Twilio) notifications, including date/time and the hostname that sent the alert
  • mail/SMS alert rate limiting, to avoid blowing through your Twilio/Mailgun quota
  • customizable delay between first detecting a down condition and sending alert
  • logging of down/alert/ok events

Deployment

Make a copy of the script and put it somewhere like ~/scripts/healthcheck-website.sh. Make it executable. Change the variables at the top of the script, and customize the check function, to get the script set up for whatever you're monitoring. Schedule it via cron however frequently you want.

Email

I use Mailgun to ensure reliable delivery of mail from my servers. Set it up for the system following eg. this guide.

SMS

SMS alerts are sent via Twilio. You'll need to configure that via the Twilio variables in the script.

macOS

The script requires the GNU version of date to be named gdate and be available in the PATH. Install it via Homebrew with brew install coreutils.