surebert/monitor-http-status

Used to monitor http server statuses and log and notify issues

dev-master 2023-02-04 00:53 UTC

Requires

• php: >=7.1
• monolog/monolog: ^1.23

MIT

• Paul Visco

• surebert
• http-status
• monitor-http-status

README

Used to monitor http status of websites and notify if needed

Install with composer

mkdir monitor-http-status;
cd monitor-http-status;
composer require surebert/monitor-http-status:dev-master

Installing as a command line tool

You can convert this into a command line tool using the installer

php vendor/surebert/monitor-http-status/installation/install.php

Afterwards you will find a monitor-http-status command in the ./bin directory

You could copy this to somewhere in your path e.g. /usr/local/bin/monitor-http-status if you want to be able to use it from elsewhere

This example copies the command to /usr/local/bin and makes it runnable by all users

sudo cp ./bin/monitor-http-status /usr/local/bin/monitor-http-status
sudo chmod a+rx /usr/local/bin/monitor-http-status

To run, make your log base directory and then run the command You may have to change the ownership on the directory depending on who you are running as

./bin/monitor-http-status -v -e=[e-mail] -u=https://somesite.com,https://some-other.com

Running as a service with logging to central log

If you want to run this command as a service

Installing as Init.d System Service

The installation/services/sysv/etc/init.d/monitor-http-status file can be used as a system service simply copy the file into /etc/init.d/monitor-http-status on your server and make it executable

sudo cp vendor/surebert/monitor-http-status/installation/services/sysv/etc/init.d/monitor-http-status /etc/init.d/ ;
sudo chmod 0755 /etc/init.d/monitor-http-status

Now because we don't want this running as root to reduce attack vector, add a user for this service

sudo useradd monitor-http-status;

Then edit the file to watch the URLs you want and to send to the email you want near the top of the file in the SCRIPT definition

sudo nano /etc/init.d/monitor-http-status

Then test the command

sudo service monitor-http-status start

If its working you should see logs in /var/log/monitor-http-status.log

If everything works out, you can set it to start on server boot

sudo chkconfig monitor-http-status on

Building your own version of the command

You could easily change the command functionality by editing the cli.php file in installation/cli.php before compiling into the command above

For example you could replace the notification function with something that sends SMS

You could replace file based logging with something decentralized

When done just rerun, the install command from the base directory