rootpd/nette-sentry

Nette Sentry 日志库

2.2.0 2024-01-05 10:53 UTC

This package is auto-updated.

Last update: 2024-09-05 14:03:48 UTC


README

Build Status

Tracy 日志扩展,能够将消息和错误记录到 Sentry。

注意:如果您在应用程序中启用了调试模式,则日志只会发送 \Tracy\Debugger::log() 消息到 Sentry。任何以 Tracy 蓝屏结束的异常将不会被记录,因为您可以直接看到异常的详细信息。

安装

通过 Composer 安装包

composer require rootpd/nette-sentry

配置

在 Nette 配置文件中启用并配置扩展

extensions:
	# ...
	sentry: Rootpd\NetteSentry\DI\SentryExtension

sentry:
    dsn: https://123abc123abc123abc123abc123abc12@sentry.io/3 # required
    environment: production # optional, defaults to "local"
    user_fields: # optional, defaults to empty array; Nette's identity ID is being sent automatically
        - email
    session_sections: # optional, list of session sections to track
        - mySection
    priority_mapping:
        mypriority: warning

优先级-严重性映射

有时您可能需要在 Nette 中使用自定义 优先级 来记录错误

\Tracy\Debugger::log('foo', 'mypriority');

Sentry 只允许严格的严重性集合。默认情况下,任何具有未知(非标准)严重性的消息都不会被记录。

您可以通过使用如示例中所示的 priority_mapping 在配置中将您的自定义 优先级 映射到 Sentry 的 严重性

允许的 Sentry 严重性集合可以在 Sentry 的 PHP 仓库 中检查。

使用方法

一旦作为扩展启用,您就可以继续抛出异常而无需任何更改。要记录消息,请使用 \Tracy\Debugger::log() 方法。