README

安装

使用Composer安装

composer require potsky/rollbar-laravel

从Rollbar.com -> 设置 -> 项目访问令牌添加项目访问令牌 post_server_item 到 .env

ROLLBAR_TOKEN=[your Rollbar project access token]

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

Rollbar\Laravel\RollbarServiceProvider::class,

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

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

配置

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

'rollbar' => [
    'access_token' => env('ROLLBAR_TOKEN'),
    'level' => env('ROLLBAR_LEVEL'),
    'person_fn' => function() {
		if (Auth::user()) {
			return [
				'id'       => strval(Auth::user()->id),
				'username' => strval(Auth::user()->name),
				'email'    => strval(Auth::user()->email),
			];
		} else {
			return [];
		}
	}
],

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

如果您编译配置文件，请不要直接使用回调函数。例如，在辅助包含中定义函数，并按如下方式配置服务

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

在辅助文件中

function get_rollbar_person() {
	if (Auth::user()) {
		return [
			'id'       => strval(Auth::user()->id),
			'username' => strval(Auth::user()->name),
			'email'    => strval(Auth::user()->email),
		];
	} else {
		return [];
	}
}

用法

Laravel处理的致命错误和异常将自动发送到Rollbar。您不需要在 app/Exceptions/Handler.php 中添加任何内容。

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

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

上下文信息

您可以传递额外的信息

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