Yii-Sentry

Sentry log route for Yii framework

The extension allows to setup multiple sentry clients. An example use case could be using Sentry's projects to log to your web, worker and/or back-end project.

Requirements

• Yii Framework > 1.1.x (Have not test any other frameworks)
• Sentry Account - OR - Your own Sentry server

Usage

Download

Unzip the extension under protected/extensions/yii-sentry

Configure

You will need to configure 2 components, namely RSentryClient & RSentryLogRoute

RSentryClient is the client component and encapsulates the raven-php client.

RSentryLogRoute is the LogRouter that uses a client to sends the logs

return array(
    .....
    'components'=>array(
        'sentry'=>array(
            'class'=>'ext.yii-sentry.components.RSentryClient',
            'dsn'=>'<YOUR_DSN>',
        ),
        'log'=>array(
            'class'=>'CLogRouter',
            'routes'=>array(
                array(
                    'class'=>'ext.yii-sentry.components.RSentryLogRoute',
                    'levels'=>'error, warning',
                ),
                .....
            ),
        ),
    ),
);

Optional client configuration

'sentry'=>array(
    'enabled'=>true // Optional (Defaults to true) - Whether to enable sending logs to Sentry, i.e. turn ON/OFF
    'options'=>array( // Optional (Defaults to empty array) - The Raven_Client configuration options, see: https://github.com/getsentry/raven-php#configuration
        'name'=>'my-server-hostname',
        'tags'=>array(
            'php_version'=>phpversion(),
        ),
    ),
),

Optional LogRoute configuration

array(
    'sentryComponent'=>'sentry', // Optional (Defaults to 'sentry') - The component ID of the RSentryClient to send the logs to
    'ravenLogCategory'=>'raven' // Optional (Defaults to 'raven') - Any errors encountered within the extension will be logged with this category
),

Acknowledgements

• Thanks to the Sentry Team for raven-php and of course, Sentry
• Thanks to @rolies106 for yii-sentry-log which served as inspiration for this extension