ecom / sentry
Sentry for the Yii2 PHP framework.
Requires
- raven/raven: 0.8.*
Requires (Dev)
- yiisoft/yii: >=1.1.14
This package is auto-updated.
Last update: 2024-11-19 19:37:45 UTC
README
Sentry for the Yii PHP framework 2.
ecom/sentry is an extension for Yii2 that allows for sending data to Sentry. It comes with an application component that allows for centralized access to the Raven client, an error handler that sends errors and exception to Sentry and a log route that sends log messages to Sentry. It has never been this easy to professionally manage your errors.
Features
- Application component for easy access to the Raven client
- Error handler that sends errors to Sentry
- Log route that sends messages to Sentry
Resources
Setup
The easiest way to install this extension is to use Composer by adding the following to your composer.json file:
"require": { "crisu83/yii-sentry": "<replace-with-latest-version>" }
Run the following command in the root directory of your project to install the extension:
php composer.phar install
TIP: Create a path alias to Composer's vendor directory called vendor to ease class mapping to dependencies by adding it to
aliases
in your application configuration.
If you do not want to use Composer, you can download the extension and its dependencies and set everything up manually.
Once you have downloaded the extension add the following to your application configuration:
'components' => array( 'sentry' => array( 'class' => 'vendor.crisu83.yii-sentry.components.SentryClient', 'dns' => '<replace-with-your-sentry-dns>' ), ),
The following configuration parameters are available for the SentryClient:
- dns: (string) dns to use when connecting to Sentry
- environment: (string) name of the active environment
- enabledEnvironments: (array) list of names for environments in which data will be sent to Sentry
- options: (array) options to pass to the Raven client with the following structure:
- logger: (string) name of the logger
- auto_log_stacks: (bool) whether to automatically log stacktraces
- name: (string) name of the server
- site: (string) name of the installation
- tags: (array) key/value pairs that describe the event
- trace: (bool) whether to send stacktraces
- timeout: (int) timeout when connecting to Sentry (in seconds)
- exclude: (array) class names of exceptions to exclude
- shift_vars: (bool) whether to shift variables when creating a backtrace
- processors: (array) list of data processors
Sending errors to Sentry
To enable the SentryErrorHandler add the following to your application configuration:
'components' => array( 'errorHandler' => array( 'class' => 'vendor.crisu83.yii-sentry.components.SentryErrorHandler', ), ),
The following configuration parameters are available for the SentryErrorHandler:
- sentryClientID: (string) component ID for the sentry client
That's it, now errors and exceptions will be sent to Sentry.
Sending log messages to Sentry
To enable the SentryLogRoute add the following to your application configuration:
'components' => array( 'log' => array( 'class' => 'CLogRouter', 'routes' => array( array( 'class' => 'vendor.crisu83.yii-sentry.components.SentryLogRoute', 'levels' => 'error, warning', ), ), ), ),
The following configuration parameters are available for the SentryLogRoute:
- sentryClientID: (string) component ID for the sentry client
That's it, now log messages with levels error and warning will be sent to Sentry.
TIP: Do not log messages with level trace to Sentry because it will slow down your application a lot.