​

Configuration#

Create a bugsnag.php file under your /config directory with the following options available to you. You can also use multi-environment options to change these per environment.

The below shows the defaults already used by Bugsnag, so you don't need to add these options unless you want to modify the values.

<?php

return [
    '*' => [
        'enabled' => true,
        'serverApiKey' => '',
        'browserApiKey' => '',
        'releaseStage' => 'production',
        'appVersion' => '',
        'notifyReleaseStages' => ['production'],
        'filters' => ['password'],
        'blacklist' => [],
        'metaData' => [],
    ],
];

​

Configuration options#

• enabled - Whether to enable the Bugsnag plugin.
• serverApiKey - The server API key for Bugsnag.
• browserApiKey - The browser API key for Bugsnag.
• releaseStage - The release stage to send to Bugsnag.
• appVersion - The app version to send to Bugsnag.
• notifyReleaseStages - The release stages to send to Bugsnag.
• filters - Any data to filter from payloads sent to Bugsnag.
• blacklist - A collection of handlers for excluding exceptions sent to Bugsnag.
• metaData - Additional metadata sent to Bugsnag.

​

Blacklisting exceptions#

If you want to ignore a certain type of exception, like a 404-error:

<?php

use yii\web\NotFoundHttpException;

return [
    'blacklist' => [
        [
            'label' => '404 errors etc',
            'class' => function($exception) {
                if ($exception instanceof NotFoundHttpException && $exception->statusCode === 404) {
                    return false;
                }

                return true;
            },
        ],
    ],  
];

​

Control Panel#

You can also manage configuration settings through the Control Panel by visiting Settings → Bugsnag.