2017 © Pedro Peláez
 

yii2-extension yii2-sentry-log

A Yii2 component for Sentry allowing data arrays passing through Yii2 logging methods

image

mitrm/yii2-sentry-log

A Yii2 component for Sentry allowing data arrays passing through Yii2 logging methods

  • Friday, January 20, 2017
  • by mitrm
  • Repository
  • 1 Watchers
  • 0 Stars
  • 35 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 1 Versions
  • 9 % Grown

The README.md

Yii2 sentry log

Yii2 Sentry component allowing for unified array format passing parameters to Sentry log target and other log targets. The ability to pass arrays as the log message is suitable practice for those who want to use Logstash, ElasticSearch, etc. for getting statistical inferences of these data later on., (*1)

Install

php composer.phar require --prefer-dist mitrm/yii2-sentry-log "dev-master"

In config file:, (*2)

'bootstrap' => ['log', 'raven'],
'components' => [
    'raven' => [
        'class' => 'mitrm\sentry\ErrorHandler',
        'dsn' => '', // Sentry DSN
    ],
    'log' => [
        'targets' => [
            [
                'class' => 'mitrm\sentry\Target',
                'levels' => ['error', 'warning'],
                'dsn' => '', // Sentry DSN
            ]
        ],
    ],
]

If application doesn't have raven component, the component will not try to send messages to sentry. This is useful for development environments, for example., (*3)

Usage

Exceptions and PHP errors are caught without effort. Standart Yii::(error|warning|info|trace) logging works as usual, but you also can use the following format:, (*4)

Yii::warning([
    'msg' => 'SomeWarning', // event name that will be sent to Sentry
    'data' => [ // extra data for the event
        'userId' => Yii::$app->user->id,
        'someDataOnWarningSituation' => $controller->state,
        'modelThatCausedFailure' => $model->attributes,
    ],
], 'eventCategory');

Or you can replace this with Log::warning as in the exception example below, since the exception argument is not required. Notice that eventCategory is not sent to Sentry and is used only for log messages routing and filtering., (*5)

Wherever you need to log a caught exception with stacktrace and additional data, use, (*6)

use sheershoff\sentry\Log;
// some code here
try{
    $model1->save();
}catch (\Exception $e){
    Log::warning([
        'msg' => 'ExceptionWarning', // event name that will be sent to Sentry
        'data' => [ // extra data for the event
            'userId' => Yii::$app->user->id,
            'someDataOnWarningSituation' => $controller->state,
            'modelThatCausedFailure' => $model->attributes,
        ],
    ], 'exceptionCategory', $e);
}

There are proxy methods in Log for the four Yii static methods: error, warning, info, trace. If $e is not null the component expects that it is an exception and after calling the corresponding Yii method also captures the exception for Sentry., (*7)

Also, the following use cases are possible:, (*8)

SentryHelper::extraData($task->attributes);
throw new Exception('unknown task type');

Or just capture a message with full stacktrace:, (*9)

try {
    throw new Exception('FAIL');
} catch (Exception $e) {
    SentryHelper::captureWithMessage('Fail to save model', $e);
}

Other log targets

To use the power of the component you should keep in mind that other log targets will receive arrays instead of strings in the log message. You can create a proxy class, redefining formatMessage method of the parent LogTarget, e.g.:, (*10)

namespace common\components;
use Yii;
class SyslogJsonTarget extends \yii\log\SyslogTarget
{
    /**
     * @inheritdoc
     */
    public function formatMessage($message)
    {
        list($text, $level, $category, $timestamp) = $message;
        $level = \yii\log\Logger::getLevelName($level);
        if (!is_string($text)) {
            $text = \yii\helpers\Json::encode($text);
        } else {
            $text = \yii\helpers\Json::encode(['rawstring' => $text]);
        }
        $prefix = $this->getMessagePrefix($message);
        return "{$prefix}[$level][$category] $text";
    }
}

Data precautions

  • Avoid passing resources and objects that can not be serialized in the array or rewrite formatMessage to handle that, e.g. trying to serialize PDO instance will raise fatal PHP error. Native Yii log targets will try to serialize that. One can check http://github.com/raven/raven to see how it sanitizes and handles these cases and use it's static methods.
  • Also check how raven can filter out private data such as password or sensitive financial requisites.

Inspired by

The Versions

20/01 2017

dev-master

9999999-dev

A Yii2 component for Sentry allowing data arrays passing through Yii2 logging methods

  Sources   Download

MIT

The Requires

 

by Mitskevich Ruslan

log yii2 raven sentry