Laravel Package for integration

4.1 2018-04-30 22:05 UTC


Laravel integration with Errorstream.

#Installation Instructions

First, run the following command on the terminal to download and install the package

composer require errorstream/errorstream-laravel 3.*

Next, register the service provider in the config/app.php file.

'providers' => [
     // ...

Then add the Facade to the aliases array in the config/app.php file.

'aliases' => [
    // ...
    'ErrorStream' => ErrorStream\ErrorStream\Facades\ErrorStream::class,

Then hook into the App/Exceptions/Handler.php file to send errors to our service.

public function report(Exception $e)
    if ($this->shouldReport($exception) && config('services.errorstream.enabled')) {

Add the following two configuration entries into .env. You can find your API key and project token on the project settings page for the project you wish to integrate.


Finally, Add the errorstream config entries in your config/services.php

'errorstream' => [
    'api_token'     => env('ERROR_STREAM_API_TOKEN'),
    'project_token' => env('ERROR_STREAM_PROJECT_TOKEN'),
    'enabled'       => env('ERROR_STREAM_ENABLED'),

#Tagging Anywhere within your application you can append tags on to the reports that you generate and send to Tags are great for grouping code together. You can make a call to add a tag anywhere by calling addTag(). A great place to do this would be to extend your Handler class modifications. For example:

public function report(Exception $e)
     if ($this->shouldReport($e)) {

#Adding Context Sometimes you'll need additional information in order to diagnose issues. Context is great for adding more information to errors. Maybe you want to send a build number, user id, or anything else. You can use this in anywhere in your laravel application

ErrorStream::addContext('some more details about variables that are set');