jenssegers / rollbar
Rollbar error monitoring integration for Laravel projects
Installs: 1 059 077
Dependents: 4
Suggesters: 0
Security: 0
Stars: 328
Watchers: 12
Forks: 99
Open Issues: 25
Requires
- php: >=5.4
- illuminate/support: ^4.0|^5.0
- rollbar/rollbar: ~0.15
Requires (Dev)
- mockery/mockery: ^0.9
- orchestra/testbench: ^3.0
- phpunit/phpunit: ~4.0|~5.0
- satooshi/php-coveralls: ^1.0
README
Rollbar error monitoring integration for Laravel projects. This library adds a listener to Laravel's logging component. Laravel's session information will be sent in to Rollbar, as well as some other helpful information such as 'environment', 'server', and 'session'.
Installation
Install using composer:
composer require jenssegers/rollbar
Add the service provider to the 'providers'
array in config/app.php
:
Jenssegers\Rollbar\RollbarServiceProvider::class,
If you only want to enable Rollbar reporting for certain environments you can conditionally load the service provider in your AppServiceProvider
:
public function register() { if ($this->app->environment('production')) { $this->app->register(\Jenssegers\Rollbar\RollbarServiceProvider::class); } }
Configuration
This package supports configuration through the services configuration file located in config/services.php
. All configuration variables will be directly passed to Rollbar:
'rollbar' => [ 'access_token' => env('ROLLBAR_TOKEN'), 'level' => env('ROLLBAR_LEVEL'), ],
The level variable defines the minimum log level at which log messages are sent to Rollbar. For development you could set this either to debug
to send all log messages, or to none
to sent no messages at all. For production you could set this to error
so that all info and debug messages are ignored.
Usage
To automatically monitor exceptions, simply use the Log
facade in your error handler in app/Exceptions/Handler.php
:
public function report(Exception $exception) { \Log::error($exception); //rollbar parent::report($exception); }
For Laravel 4 installations, this is located in app/start/global.php
:
App::error(function(Exception $exception, $code) { Log::error($exception); });
Your other log messages will also be sent to Rollbar:
\Log::debug('Here is some debug information');
NOTE: Fatal exceptions will always be sent to Rollbar.
Context informaton
You can pass user information as context like this:
\Log::error('Something went wrong', [ 'person' => ['id' => 123, 'username' => 'John Doe', 'email' => 'john@doe.com'] ]);
Or pass some extra information:
\Log::warning('Something went wrong', [ 'download_size' => 3432425235 ]);