Download the PHP package spatie/server-monitor-app without Composer
On this page you can find all versions of the php package spatie/server-monitor-app. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download spatie/server-monitor-app
More information about spatie/server-monitor-app
Files in spatie/server-monitor-app
Package server-monitor-app
Short Description A PHP application to monitor the health of your servers
License MIT
Homepage https://github.com/spatie/server-monitor-app
Informations about the package server-monitor-app
A PHP application to monitor your servers' health
We all dream of servers that need no maintenance at all. But unfortunately in reality this is not the case. Disks can get full, processes can crash, the server can run out of memory...
This commandline app keeps an eye on the health of all your servers. There are a few checks that come out of the box.
When something goes wrong it can notify you via Slack or mail. This is what a Slack notification looks like:
Under the hood the server-monitor-app is a vanilla Laravel 5.4 application with the laravel-server-monitor installed into it. If you know your way around Laravel, it's recommended that you use laravel-server-monitor instead of this app.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Requirements
See the requirements in the docs of the underlying package.
Installation
You can install the application by issuing this command:
To complete your installation these steps must be performed:
First you should add the following command to your cron table. It should run every minute:
Secondly, specify a Slack webhook url in the SERVER_MONITOR_SLACK_WEBHOOK_URL
key
in the .env
file found in the installation directory.
You can create a new webhook url on the Slack website.
Optionally you can configure e-mail notifications by filling in the MAIL_
keys in the .env
file located in the
installation directory and adding mail
to the notifications
array in the configuration.php
file.
Configuration
The configuration file configuration.php
is located inside the installation directory.
Reading it is a good way to quickly get a feel of what server-monitor-app
can do. Here's the content of the config file:
Basic usage
To start monitoring a server:
and answer the questions that are asked.`
To stop monitoring an url issue this command:
To list all monitors you can perform:
You can also list all active checks on all hosts:
Finally, if you've got a large amount of servers to monitor you can import them from a JSON file:
Advanced usage
Under the hood the server-monitor-app
is a vanilla Laravel 5.4 application with our laravel-server-monitor installed into it. Please refer to it's extensive documentation to know more how to configure and use this application.
By default the application will use a sqlite
database located at <installation directory>/database.sqlite
to store all monitors.
Documentation
You'll find the documentation of the underlying laravel-server-monitor
package on https://docs.spatie.be/laravel-server-monitor/v1.
Find yourself stuck using this app or the underlying package? Found a bug? Do you have general questions or suggestions for improving the uptime monitor? Feel free to create an issue on GitHub, we'll try to address it as soon as possible.
Postcardware
You're free to use this package (it's MIT-licensed), but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium.
The best postcards will get published on the open source page on our website.
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you've found a bug regarding security please mail [email protected] instead of using the issue tracker.
Credits
- Freek Van der Herten
- Alex Vanderbist
- All Contributors
About Spatie
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
License
The MIT License (MIT). Please see License File for more information.