Download the PHP package ericmakesstuff/laravel-server-monitor without Composer
On this page you can find all versions of the php package ericmakesstuff/laravel-server-monitor. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ericmakesstuff/laravel-server-monitor
More information about ericmakesstuff/laravel-server-monitor
Files in ericmakesstuff/laravel-server-monitor
Package laravel-server-monitor
Short Description Server Monitoring Command for Laravel Applications
License MIT
Informations about the package laravel-server-monitor
Server monitoring for Laravel apps
This Laravel 5 package will periodically monitor the health of your server and website. Currently, it provides healthy/alarm status notifications for Disk Usage, an HTTP Ping function to monitor the health of external services, and a validation/expiration monitor for SSL Certificates.
Once installed, monitoring your server is very easy. Just issue this artisan command:
You can run only certain monitors at a time:
How It Works
Using the configuration file in your project, any number of monitors can be configured to check for problems with your server setup.
When the monitor:run
artisan command is executed, either from the command line or using the Laravel command scheduler, the monitors run and
alert if there is an issue. The alarm state is configurable, and alerts can be sent to the log, or via email, Pushover, and Slack.
Disk Usage Monitors
Disk usage monitors check the percentage of the storage space that is used on the given partition, and alert if the percentage exceeds the configurable alarm percentage.
HTTP Ping Monitors
HTTP Ping monitors perform a simple page request and alert if the HTTP status code is not 200. They can optionally check that a certain phrase is included in the source of the page.
SSL Certificate Monitors
SSL Certificate monitors pull the SSL certificate for the configured URL and make sure it is valid for that URL. Wildcard and multi-domain certificates are supported.
The monitor will alert if the certificate is invalid or expired, and will also alert when the expiration date is approaching. The days on which to alert prior to expiration is also configurable.
Installation and usage
You can install this package via composer using:
composer require ericmakesstuff/laravel-server-monitor
You'll need to register the ServiceProvider:
To publish the config file to app/config/server-monitor.php run:
php artisan vendor:publish --provider="EricMakesStuff\ServerMonitor\ServerMonitorServiceProvider"
Monitor Configuration
After publishing the configuration file, you can edit the 'monitors'
section of app/config/server-monitor.php.
The default monitor configurations are:
Alert Configuration
Alerts can be logged to the default log handler, or sent via email, Pushover, or Slack. Allowed values are log
, mail
, pushover
, and slack
.
The default alert configurations are:
Scheduling
After you have performed the basic installation you can start using the monitor:run command. In most cases you'll want to schedule this command so you don't have to manually run monitor:run every time you want to know the health of your server.
The commands can, like an other command, be scheduled in Laravel's console kernel.
Of course, the schedules used in the code above are just an example. Adjust them to your own preferences.
Testing
Run the tests with:
Next Steps
More monitoring metrics. Feel free to submit ideas via issues or pull requests!
Ideas
- Remote server disk space usage (over SSH)
- NTP Offset in seconds
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Eric Blount - Author
- Freek Van der Herten - Inspiration/Base Package (Backup)
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-server-monitor with dependencies
illuminate/console Version ^5.1
guzzlehttp/guzzle Version ~6.0