jenssegers/rollbar

为 Laravel 项目提供的 Rollbar 错误监控集成

v1.5.1 2017-01-25 08:34 UTC

This package is auto-updated.

Last update: 2024-08-25 19:20:43 UTC


README

Build Status Coverage Status

Rollbar 错误监控集成为 Laravel 项目。此库为 Laravel 的日志组件添加了监听器。Laravel 的会话信息将被发送到 Rollbar,以及一些其他有用的信息,如 '环境'、'服务器' 和 '会话'。

rollbar

安装

使用 composer 安装

composer require jenssegers/rollbar

将服务提供者添加到 config/app.php 中的 'providers' 数组

Jenssegers\Rollbar\RollbarServiceProvider::class,

如果您只想为某些环境启用 Rollbar 报告,您可以在 AppServiceProvider 中有条件地加载服务提供者

    public function register()
    {
        if ($this->app->environment('production')) {
            $this->app->register(\Jenssegers\Rollbar\RollbarServiceProvider::class);
        }
    }

配置

此包支持通过位于 config/services.php 的服务配置文件进行配置。所有配置变量将直接传递给 Rollbar

'rollbar' => [
    'access_token' => env('ROLLBAR_TOKEN'),
    'level' => env('ROLLBAR_LEVEL'),
],

level 变量定义了将日志消息发送到 Rollbar 的最小日志级别。对于开发,您可以将其设置为 debug 以发送所有日志消息,或设置为 none 以发送所有消息。对于生产,您可以将其设置为 error 以忽略所有信息和调试消息。

用法

要自动监控异常,只需在 app/Exceptions/Handler.php 中的错误处理器中使用 Log 门面即可

public function report(Exception $exception)
{
    \Log::error($exception); //rollbar
    parent::report($exception);
}

对于 Laravel 4 安装,它位于 app/start/global.php

App::error(function(Exception $exception, $code)
{
    Log::error($exception);
});

您的其他日志消息也将被发送到 Rollbar

\Log::debug('Here is some debug information');

注意:致命异常将始终发送到 Rollbar。

上下文信息

您可以像这样将用户信息作为上下文传递

\Log::error('Something went wrong', [
    'person' => ['id' => 123, 'username' => 'John Doe', 'email' => 'john@doe.com']
]);

或传递一些额外的信息

\Log::warning('Something went wrong', [
    'download_size' => 3432425235
]);