Download the PHP package mohsenabrishami/stethoscope without Composer

Features | Installation | Usage | Dashboard | Configuration | Notification | Testing | Changelog | Contributing | Credits | License

This Laravel package allows you to monitor the infrastructure.

With this package, You can check your server health at any time.

Features

• Monitoring CPU usage percentage

• Monitoring memory usage percentage

• Monitoring Storage free space

• Checking the network connection status

• Checking web Server status (Nginx/Apache)

• Recording log when CPU, memory, and Storage usage exceeds the specified threshold

• Recording log when the network connection fails or the web server deactivated

• Sending email when a problem occurs in the CPU, memory, Storage, web server, and network of server

Do you need more options? you can make an issue or contributes to the package

Get Started

Requirements

• PHP 8.0+
• Laravel 8+
• Linux Operating System (Debian, Ubuntu, mint, ...)

Installation

This package requires PHP 8.0 and Laravel 8.0 or higher. You can install the package via composer:

and then run:

Stethoscope allows you to record reports both in a file and in a database. If you set the database driver in the config file, you must run migrate command:

Usage

Once installed, see your server health details with a command:

The output will be like this:

But the work of this package didn't stop there. you can set thresholds for CPU, memory and Storage consumption. if CPU and memory consumption exceeds thresholds or Storage free space is less than thresholds, then a log is created from details consumption. also, you can config this package so that if the deactivated web server or disconnected internet log is created. To start monitoring your server, just run this command:

You can monitor your server constantly with the run this command by a cron job. You may want to be notified if there is a problem in the server. For this, it is enough to set your email admin in the config file.

If you are worried about the increase in logs, use the following command. This command deletes old logs based on the number of days you defined in the config file.

Dashboard

Stethoscope provides a dashboard where you can easily see the current status of the server at any time. Also, in this dashboard, you can see a history of the times when resource consumption exceeded the limit or when the network and web server were disabled.

If you use the monitoring panel, you must publish the build files:

Remember that the monitoring dashboard is disabled by default. To activate, you must set monitoring_panel.status to true in config file. Also, the log storage driver must be a database, not a file.

You can put a key to access the admin panel. If you define a key, you can access the dashboard only when you enter the key in the address.

you can access this panel with address https://yoursite/monitoring-panel?key=sampletoken

Configuration

You can easily customize this package in the config/stethoscope.php.

In this file, You can configure the following:

• Resources that should be monitored. We can monitor the CPU, memory, Storage, network connection, and web server status.

• Web server that is installed on your server. We support Nginx and apache.

• Storage driver and path to saving log files.

• Resources Thresholds. Include maximum CPU and memory usage and minimum Storage space.

• Custom network URL for network connection monitor.

• Driver to save resource logs (support file storage and database).

• Emails address to send notification emails when your server has problems.

• Number of days for which resource logs must be kept.

By default, the configuration looks like this:

Notification

stethoscope can send you server problems through notifications. By default, sending notifications via email is supported. To use this feature, you must enter the email address of the admin user in the config file.

Adding extra notification channels

It's easy to add an extra notification channel such as Telegram or native mobile push notification, etc. In the following example we're going to add the Telegram push notifications channel. Other notification drivers can be added in the same way.

1. Install the notification channel driver

First you need to create your custom driver. For Telegram push notifications, you can use following package:

After composer has pulled in the package, just follow the installation instructions of the package to complete the installation.

2. Creating your own custom notification

In the following, you'll need to create your own notification class like the one below:

3. Creating your own custom notifiable

Also, you should create notifiable class. For this example, as you can see below, the Telegram channel ID should be returned:

4. Register your custom notification in the config file

Finally, you should register notification and notifiable classes and add the telegram channel id:

Testing

Run the tests with:

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Credits

• Mohsen Abrishami

License

The MIT License (MIT). Please see License File for more information.