ecom/sentry

Sentry for the Yii2 PHP框架。

1.3.0 2014-02-10 13:59 UTC

This package is auto-updated.

Last update: 2024-09-19 19:12:40 UTC


README

Latest Stable Version

Yii PHP框架2的Sentry

ecom/sentry 是一个为 Yii2 框架设计的扩展,允许将数据发送到 Sentry。它包括一个应用组件,允许集中访问 Raven 客户端,一个错误处理器,将错误和异常发送到 Sentry,以及一个日志路由器,将日志消息发送到 Sentry。从未如此容易地专业管理您的错误。

特性

  • 用于轻松访问 Raven 客户端的应用组件
  • 将错误发送到 Sentry 的错误处理器
  • 将消息发送到 Sentry 的日志路由器

资源

配置

安装此扩展的最简单方法是使用 Composer,在您的 composer.json 文件中添加以下内容

  "require": {
    "crisu83/yii-sentry": "<replace-with-latest-version>"
  }

在项目根目录中运行以下命令以安装扩展

php composer.phar install

提示:创建一个指向 Composer 的 vendor 目录的路径别名,名为 vendor,通过将其添加到您的应用程序配置中的 aliases,以便轻松映射到依赖项。

如果您不想使用 Composer,您可以下载扩展及其依赖项,然后手动设置一切。

下载扩展后,将其添加到您的应用程序配置中

  'components' => array(
    'sentry' => array(
      'class' => 'vendor.crisu83.yii-sentry.components.SentryClient',
      'dns' => '<replace-with-your-sentry-dns>'
    ),
  ),

以下配置参数适用于 SentryClient

  • dns: (string) 连接到 Sentry 时使用的 dns
  • environment: (string) 活动环境的名称
  • enabledEnvironments: (array) 将数据发送到 Sentry 的环境名称列表
  • options: (array) 传递给 Raven 客户端的选项,其结构如下
    • logger: (string) 记录器名称
    • auto_log_stacks: (bool) 是否自动记录堆栈跟踪
    • name: (string) 服务器名称
    • site: (string) 安装名称
    • tags: (array) 描述事件的键/值对
    • trace: (bool) 是否发送堆栈跟踪
    • timeout: (int) 连接到 Sentry 的超时时间(秒)
    • exclude: (array) 要排除的异常类名称
    • shift_vars: (bool) 创建回溯时是否移动变量
    • processors: (array) 数据处理器列表

将错误发送到 Sentry

要启用 SentryErrorHandler,请将以下内容添加到您的应用程序配置中

  'components' => array(
    'errorHandler' => array(
      'class' => 'vendor.crisu83.yii-sentry.components.SentryErrorHandler',
    ),
  ),

以下配置参数适用于 SentryErrorHandler

  • sentryClientID: (string) sentry 客户端组件 ID

就这样,现在错误和异常将被发送到 Sentry。

将日志消息发送到 Sentry

要启用 SentryLogRoute,请将以下内容添加到您的应用程序配置中

  'components' => array(
    'log' => array(
      'class' => 'CLogRouter',
      'routes' => array(
        array(
          'class' => 'vendor.crisu83.yii-sentry.components.SentryLogRoute',
          'levels' => 'error, warning',
        ),
      ),
    ),
  ),

以下配置参数适用于 SentryLogRoute

  • sentryClientID: (string) sentry 客户端组件 ID

就这样,现在带有 errorwarning 级别的日志消息将被发送到 Sentry。

提示:不要将带有 trace 级别的日志消息发送到 Sentry,因为它会大大减慢您的应用程序。