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

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

tiny bash-based healthcheck/monitoring tool, with rate limiting, email & twilio notifications

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Used by

Contributors

Languages