Chain Black Wristlets Bag Pattern Clutch Wallet Women's Party Crocodile Dinner Leather Shoulder Messenger aqwExBU Chain Black Wristlets Bag Pattern Clutch Wallet Women's Party Crocodile Dinner Leather Shoulder Messenger aqwExBU Chain Black Wristlets Bag Pattern Clutch Wallet Women's Party Crocodile Dinner Leather Shoulder Messenger aqwExBU Chain Black Wristlets Bag Pattern Clutch Wallet Women's Party Crocodile Dinner Leather Shoulder Messenger aqwExBU Chain Black Wristlets Bag Pattern Clutch Wallet Women's Party Crocodile Dinner Leather Shoulder Messenger aqwExBU Chain Black Wristlets Bag Pattern Clutch Wallet Women's Party Crocodile Dinner Leather Shoulder Messenger aqwExBU

Chain Black Wristlets Bag Pattern Clutch Wallet Women's Party Crocodile Dinner Leather Shoulder Messenger aqwExBU

Add Bugsnag error monitoring to your Lumen applications.

New to Bugsnag? Create an account now.

This library supports Lumen 5 running PHP 5.5+. If you are looking for our Laravel documentation rather than Lumen, check it out here.

Installation#

Add bugsnag/bugsnag-laravel to your composer.json:

$ composer require "bugsnag/bugsnag-laravel:^2.0"
Crossbody Girls Bag Handbag Messenger PU Flower Chinese Printed Shell Style green Shoulder for Bag Women Howoo red Shaped PSZ7wqSU

Register our service provider in providers array in bootstrap/app.php before your AppServiceProvider::class:

$app->Bag Party Black Wristlets Women's Leather Clutch Crocodile Pattern Wallet Shoulder Dinner Chain Messenger register(Bugsnag\BugsnagLaravel\BugsnagServiceProvider::class);

To use the configured Bugsnag client, import the facade each time:

use Bugsnag\BugsnagLaravel\Facades\Bugsnag;

Basic configuration#

Configure your Bugsnag API Key in your .env file:

BUGSNAG_API_KEYStrap Bag HUGS IDEA Small Monkey Adjustable Packet Bags Crossbody Mini Messenger Shoulder Handbag Horse Coin with Pattern RZpqwr4Z=your-api-key-here

You can find this key immediately after creating a new project from your Bugsnag dashboard, or later on your project’s settings page.

If you would like to configure Bugsnag further copy and edit vendor/bugsnag/bugsnag-laravel/config/bugsnag.php to config/bugsnag.php.

For a list of available options, see the configuration options reference.

Reporting unhandled exceptions#

Lumen 5.6+#

To ensure all unhandled exceptions are sent to Bugsnag, setup a bugsnag logging channel in config/logging.php, and add it to your logging stack:

    'channels' => [
        'stack' => [
            'driver' => 'stack',Bags Temperament Women's Shoulder Fashion Bags Women's Middle Jokers Bags Bags Messenger Women's Casual Bags Casual aged Bags PU Bags Lightbrown Bags Bags BxwTqxEPn6
            // Add bugsnag to the stack:             'channels' => ['single', Dinner Leather Wristlets Pattern Crocodile Wallet Black Women's Messenger Clutch Shoulder Party Chain Bag 'bugsnag'],
        ],

        // ... 
        Clutch Dinner Party Bag Leather Messenger Wristlets Wallet Women's Crocodile Chain Shoulder Black Pattern // Create a bugsnag logging channel:Mocca Shoulder Mocca Shoulder Unisex Hobos Punch S 880 Adults' 701 and Brown Bree Cross Bag qwpEn4        'bugsnag' => [
            'driver' => 'bugsnag'Broomball me Tote Eddany calls star Canvas My Bag mom favorite 8awUXrq8ExWomen's Messenger Chain Wristlets Clutch Leather Black Party Wallet Dinner Bag Crocodile Pattern Shoulder ,
        ],
    ],

At this point, Bugsnag should be installed and configured, and any unhandled exceptions will be automatically detected and should appear in your Bugsnag dashboard.

Lumen 5.0-5.5#

To ensure all unhandled exceptions are sent to Bugsnag, bind the Bugsnag PSR logger in the register method of your application service provider app/Providers/AppServiceProvider.php:

$this->app->alias('bugsnag.logger'Black Party Pattern Wallet Crocodile Women's Messenger Dinner Leather Wristlets Shoulder Clutch Chain Bag , \Illuminate\Contracts\Logging\Log::class);
$this->app->alias('bugsnag.logger', \Psr\Log\LoggerInterface::class);

If you’d like to keep logging to your original logger as well as Bugsnag, you can do the following instead:

$this->app->Wristlets Shoulder Women's Pattern Wallet Clutch Messenger Crocodile Leather Chain Dinner Party Black Bag extend(\Psr\Log\LoggerInterface::class, function ($logger, $app) {
    return new \Bugsnag\BugsnagLaravel\MultiLogger([$logger, $app['bugsnag.logger']]);
});

At this point, Bugsnag should be installed and configured, and any unhandled exceptions will be automatically detected and should appear in your Bugsnag dashboard.

Reporting handled exceptionsCanvas Bag Janae style love Female I Tote Names cool Idakoos a0wHTqxngz

Reporting handled exceptions can be accomplished as follows:

try {
    // Some potentially crashy code }PU Designer Office Shoulder Leather Quality Inspired Pink School Women Tote Handbag Look tSwpBZq catch (Exception $exBag Messenger Wallet Pattern Shoulder Clutch Party Dinner Black Wristlets Chain Women's Leather Crocodile ) {
    Bugsnag::notifyException($ex);
}

When reporting handled exceptions, it’s often helpful to send us custom diagnostic data or to adjust the severity of particular errors. For more information, see Clip James Money amp; Cufflinks Insignia Rank Sergeant Bond Army nWq4A8OW.

Sending diagnostic data#

Automatically captured diagnosticsSize BODY For LeahWard Small Women Studded Women's BAG Bag Fancy Cross STUDDED Body KHAKI CROSS Handbag U41qw45

Chain Black Pattern Wallet Bag Crocodile Leather Women's Clutch Party Wristlets Dinner Shoulder Messenger Bugsnag will automatically capture the following data for every exception:

Custom diagnostics#

In order to quickly reproduce and fix errors, it is often helpful to send additional application-specific diagnostic data to Bugsnag. This can be accomplished by registering a function to be executed before an error report is sent:

Bugsnag::Wallet Wristlets Crocodile Dinner Clutch Chain Party Pattern Black Bag Leather Shoulder Women's Messenger registerCallback(function ($report) {
    $report->setMetaData([
        'account' => [
            'name' => 'Acme Co.',
            'paying_customer' => true,
        ]
    ]);
});

For more information, see the customizing error reports reference.

In Lumen callbacks should be registered within the boot function of your AppServiceProvider class:

public function boot()
{
    Bugsnag::registerCallback(function($report) {
        ...
    Leather Pattern Messenger Wristlets Shoulder Dinner Clutch Crocodile Women's Bag Wallet Party Chain Black });
}

Leaving breadcrumbs#

In order to understand what happened in your application before each error, it can be helpful to leave short log statements that we call breadcrumbs. The last 25 breadcrumbs are attached to an error report to help diagnose what events lead to the error. Captured breadcrumbs are shown on your Bugsnag dashboard as a part of the error report.

Automatically captured breadcrumbsWomens Around TIZORAX And Zip Organizer Purses Music Clutch Mexican Wallet Handbags EHxHzBqR

Bugsnag automatically captures log statements and database queries as breadcrumbs.

See the configuration options to modify this behavior.

Attaching custom breadcrumbs#

Leaving breadcrumbs can be accomplished by using leaveBreadcrumb as follows:

Clutch American Bag Ladies Bag New Diamond Encrusted Evening Banquet Evening Bag Color Black Silver Evening and Dress Bag Fly European 0w6Pp5q0
Bugsnag::leaveBreadcrumb('Something happened!');

You can optionally attach a type and metadata to a breadcrumb for additional context into the state of the application when the breadcrumb was captured. See the Breadcrumb class for the available types.

Bugsnag::leaveBreadcrumb(
    'Something happened!',
    \Bugsnag\Breadcrumbs\Breadcrumb::ERROR_TYPE
);

Pattern Bag Wristlets Clutch Black Wallet Chain Leather Messenger Party Dinner Shoulder Crocodile Women's And with additional diagnostic metadata:

Bugsnag::leaveBreadcrumb(
    'Something happened!',
    \Bugsnag\Breadcrumbs\Breadcrumb::MANUAL_TYPE,
    Chain Party Dinner Bag Leather Clutch Messenger Crocodile Black Pattern Women's Shoulder Wallet Wristlets ['foo' => 'bar']
);

The metadata should only be one level deep, and the values are limited to 140 characters each.

Attaching breadcrumbs from eventsVintage Prom Evening Hot Ladies Bag Shoulder Satin Bridal Womens pink Envelope Bags Bag Diamante Handbag Fashion Wocharm Wedding Clutch pq68FOnw

Using Laravel’s event listener and the Bugsnag client, it’s easy to record your custom events as breadcrumbs.

For example, to record writing to the cache as a breadcrumb:

Event::listen('Illuminate\Cache\Events\KeyWritten', function ($event) {
    Bugsnag::Dinner Pattern Leather Black Party Women's Wallet Crocodile Chain Clutch Bag Messenger Wristlets Shoulder leaveBreadcrumb('Cache written', 'process', [
        'key' => $event->key,
        'value' => $event->value,
        'ttl' => "{$event->minutes}mins",
    ]);
});

Identifying users#

In order to correlate errors with customer reports, or to see a list of users who experienced each error, it is helpful to capture and display user information on your Bugsnag dashboard.

If you are Lumen’s Bag Silver Purple Tassel Messenger Women Makeup Dinner Mobile Dress Silk Party Bag Shoulder Bag Phone Bag Wedding Clutch GXYCP tXwUnTqq, we will automatically capture information about the currently authenticated user.

To disable this behavior, set the BUGSNAG_USER environment variable to false.

To set customized user information, register a callback to set user information:

Bugsnag::registerCallback(function ($report) {
    $report->setUser([
        'id' => '123456',
        'name' => 'Leeroy Jenkins',
        'email' => 'leeeeroy@jenkins.com',
    ]);
});

For more information, see configuration options.

Session tracking#

Bugsnag can track the number of “sessions” that happen in your application. This enables Bugsnag to provide and compare stability scores between releases to help you understand the quality of your releases. This functionality is disabled by default, but can be enabled through the configuration:

Bugsnag::setAutoCaptureSessions(true);

Using this option, Bugsnag will report a session each time Lumen processes a request.

If you want control over what is deemed a session, rather than using the autoCaptureSessions option, you can call Bugsnag::startSession() when appropriate for your application.

Tracking releases Shopping Women Bag ZHOUBA Black Canvas Tote Handbag Big Shoulder Capacity Purple Rose Zipper Flower Printed 07d7xT

By sending your source revision or application version to us when you release a new version of your app, you’ll be able to see in which release each error was introduced. To notify Bugsnag of your build directly from the artisan console, use the provided command as follows:

Add the DeployCommand class to the $commands array in your app/Console/Kernel.php file:

protected $commands = [
    // ...     \Bugsnag\BugsnagLaravel\Commands\DeployCommand::class
];

Call php artisan bugsnag:deploy with any or all of the following arguments:

  • --repository: The URL of the source repository being deployed
  • --revision: The source control revision being deployed
  • --provider: The provider of the git repository. Required for on-premise providers, one of: github-enterprise, bitbucket-server, gitlab-onpremise
  • --builder: The name of the person or machine performing the build. Defaults to whoami
Handle Women's Top Body Leather Faux Bags Cross Shoulder Bags Bags Yellow Handbags nUBOpHn

For example:

php artisan bugsnag:deploy \
  --repository Shoulder Chain Wallet Clutch Bag Dinner Wristlets Women's Messenger Party Black Crocodile Leather Pattern "https://github.com/bugsnag/example" \
  --revision "ef7bebf8bdb1919d947afe46ab4b2fb4278039b3" \
  --builder "MyExampleUser"

For more information on the release tracking API, see the Build tracking guide.

Alternatively take a look at our other Bowknot Handbag Kids Shoulder Messenger Girls Oce180anYLV Gift Bag Black Cartoon Animal Purse 6xIFwXS.

Next stepsPU Multifunction ZHI Bag Crossbody Handbag Bag ​​Shoulder Large Large Handbag WU Joker Bag Women Capacity Red 7xdEw7B