https://github.com/pyaesone17/lapse
Laravel Self Hosted Tiny Error Tracking System With Notifications
https://github.com/pyaesone17/lapse
error-reporting error-tracking larave-error laravel laravel-5-package
Last synced: 5 months ago
JSON representation
Laravel Self Hosted Tiny Error Tracking System With Notifications
- Host: GitHub
- URL: https://github.com/pyaesone17/lapse
- Owner: pyaesone17
- License: mit
- Created: 2017-10-13T16:56:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-09-12T05:46:00.000Z (over 7 years ago)
- Last Synced: 2025-07-13T12:50:03.260Z (10 months ago)
- Topics: error-reporting, error-tracking, larave-error, laravel, laravel-5-package
- Language: PHP
- Homepage:
- Size: 2.34 MB
- Stars: 175
- Watchers: 5
- Forks: 13
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Introducing
Lapse provides a beautiful dashboard to track your errors in production without having to look up log file.
Moreover it can notify you via Slack channel and Email alert. And moreover it can notify you via all of the channels from
http://laravel-notification-channels.com/.
Lapse behind the scence depend on https://laravel.com/docs/5.6/notifications.
It means theoretically Lapses can notify your error via over 30 ways including **Slack, Email, Nexmo, Trello, Telegram, Facebook, Discord, Pusher, Twillo, Twitte**. But I haven't test agaisnt all of the channels, If you find a bug, please submit an issue.
If you want to know more, please kindly check the link.
For old version please see documentation at https://github.com/pyaesone17/lapse/tree/v1
## Upgrade Guide
If you are upgrading from version 1.
Please delete config/lapse.php file first.
## Install
Install Via Composer
``` bash
$ composer require pyaesone17/lapse
```
Publish vendor
``` bash
$ php artisan vendor:publish
```
Add slack hook url in config/lapse.php and define channels ( https://api.slack.com/incoming-webhooks )
``` php
'channels' => [
'slack' => 'https://hooks.slack.com/services/......',
'mail' => 'your@mail.com'
],
// Currently two notification channels supported
// Those are slack and email
// But you can use all of the notifications from http://laravel-notification-channels.com/
// See the custom channel of my read me file to explore how to integrate
'via' => ['slack']
```
``` bash
$ php artisan vendor:publish
```
Migrate lapses table
``` bash
php artisan migrate
```
## Usage
after that register In the report method of App\Exceptions\Handler like this.
``` php
use Pyaesone17\Lapse\ErrorNotifiable;
..
class Handler extends ExceptionHandler
{
use ErrorNotifiable;
...
public function report(Exception $exception)
{
if( app()->environment()!='local' ){ // Remove this line if you want lapse to notify in local environment
$this->sendNotification($exception);
}
}
...
}
```
Laravel Lapse's dashboard is inspired by Laravel Horizon. Just like Horizon you can configure authentication to Lapse's dashboard. Add the following to the boot method of your AppServiceProvider. Here you could also check role permision and limit
the dasboard.
``` php
\Pyaesone17\Lapse\Lapse::auth(function($request) {
// return true / false . For e.g.
return \Auth::check();
});
```
To view the dashboard point your browser to /lapse of your app. For e.g. `laravel.dev/lapse`.
But the app is in local environment, lapse will not even attend to validate auth, It will display it all.
To delete all lapse message via cli , please run
``` bash
$ php artisan clear:lapse
```
## Custom Notification Channel
you can use all notifications from http://laravel-notification-channels.com/ to integrate with lapse
For example, Telegram
install channel via composer
``` bash
$ composer require laravel-notification-channels/telegram
```
configure the config/lapse.php first
``` php
use NotificationChannels\Telegram\TelegramChannel;
'channels' => [
'slack' => 'https://hooks.slack.com/services/......',
'telegram' => 'tele_gram_user_id', //optional
],
// Currently two notification channels is supported built in
// Those are slack and email
'via' => ['slack', TelegramChannel::class]
```
register telegram provider
``` php
// config/app.php
'providers' => [
...
NotificationChannels\Telegram\TelegramServiceProvider::class,
],
```
Set credentials
```php
// config/services.php
'telegram-bot-api' => [
'token' => env('TELEGRAM_BOT_TOKEN', 'YOUR BOT TOKEN HERE')
],
```
Add the formatter for notificaiton
``` php
use NotificationChannels\Telegram\TelegramMessage;
use Pyaesone17\Lapse\ErrorNotifiable;
..
class Handler extends ExceptionHandler
{
use ErrorNotifiable;
...
public function report(Exception $exception)
{
if( app()->environment()!='local' ){ // Remove this line if you want lapse to notify in local environment
$this->sendNotification($exception, $this->getFormatters());
}
}
protected function getFormatters()
{
$formatters = array(
'toTelegram' => function($notifiable) {
return TelegramMessage::create()
->content("*HELLO!* \n One of your invoices has been paid!");
}
);
return $formatters;
}
...
}
```
## New Feature
If you want new feature, feel free to submit as an issue
## Security
If you discover any security related issues, please email promise@gmail.com instead of using the issue tracker.
## Credits
- [All Contributors][link-contributors]
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
[ico-version]: https://img.shields.io/packagist/v//.svg?style=flat-square
[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square
[ico-travis]: https://img.shields.io/travis///master.svg?style=flat-square
[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g//.svg?style=flat-square
[ico-code-quality]: https://img.shields.io/scrutinizer/g//.svg?style=flat-square
[ico-downloads]: https://img.shields.io/packagist/dt//.svg?style=flat-square
[link-packagist]: https://packagist.org/packages//
[link-travis]: https://travis-ci.org//
[link-scrutinizer]: https://scrutinizer-ci.com/g///code-structure
[link-code-quality]: https://scrutinizer-ci.com/g//
[link-downloads]: https://packagist.org/packages//
[link-author]: https://github.com/
[link-contributors]: ../../contributors