README.md

Laravel Meter

Laravel Meter monitors application performance for different things such as requests, commands, queries, events, etc and presents results in tables/charts. Think of it like Laravel Telescope but for performance monitoring.

Requirements

• PHP >= 7
• Laravel 5.5+ | 6

Monitors

• Requests
• Queries
• Commands
• Events
• Schedule
• CPU Load
• Disk Space
• Server Memory
• HTTP Connections

Screenshot

Installation

Install via composer

composer require sarfraznawaz2005/meter

Publish package's config file by running below command:

php artisan vendor:publish --provider="Sarfraznawaz2005\Meter\MeterServiceProvider"

It should publish config/meter.php config file and migration file.

Now run php artisan migrate command to create meter_entries database table.

Usage

Enable Meter in config/meter.php and setup any other options as needed. Meter UI will be visible at path config you set.

By default Meter monitors:

• Requests
• Queries
• Commands
• Events
• Schedule

To monitor server stuff:

• CPU Load
• Disk Space
• Server Memory
• HTTP Connections

You should use meter:servermonitor command. Schedule it in Laravel's console kernel file accordingly:

// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
    $schedule->command('meter:servermonitor')->hourly(); // or daily
}

Authentication

You can use username and password config options to setup basic HTTP authentication for Meter interface to be accessed. Once setup, user should provide correct username and password to access Meter page(s).

Ignoring Things

You can use ignore_paths and ignore_commands config options to ignore desired pages or commands from being monitored by Meter.

Data Pruning

You need to periodically remove meter data otherwise your database will turn big quickly. To prune meter data, you can setup prune command in Kernel file:

$schedule->command('meter:prune')->daily();
// or
$schedule->command('meter:prune --days=7')->daily();

Contributing

PRs are welcome. Thanks

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Sarfraz Ahmed
• All Contributors

License

Please see the license file for more information.