rootpd/nette-sentry

Nette Sentry logger extension

Nette Sentry

Tracy logger extension capable of logging messages and errors to Sentry.

Note: If you have debug mode enabled in your application, logger will only send \Tracy\Debugger::log() messages to sentry. Any exception ending with Tracy's blue screen is not going to be logged as you can see the exception details directly.

Installation

Install package via Composer:

composer require rootpd/nette-sentry

Configuration

Enable and configure the extension in Nette config file:

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

sentry:
    dsn: https://[email protected]/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

Priority-Severity mapping

Sometimes you might need to use custom priority when logging the error in Nette:

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

Sentry only allows strict set of severities. By default any message with unknown (non-standard) severity is not being logged.

You can map your custom priority to Sentry's severity in config by using priority_mapping as shown in the example.

The allowed set of Sentry severities can be checked in Sentry's PHP repository.

Usage

Once enabled as extension, you can continue to throw exceptions without any change. To log message please use \Tracy\Debugger::log() method.

nette-sentry's Issues

PHP User Deprecated: Nette\Http\Session::getIterator()

See https://github.com/nette/http/releases/tag/v3.2.1

It causes session id to be different for every request

I have a problem with this extension. It causes that I can't login to my web app. I was trying to figure it out, I discovered, that session id is different for every request, this extension somehow causes it, so the session is being forgotten after every request. When I comment out this extension in neon file, everything works as usual.
There are no PHP errors in any log folder. I use the latest stable Nette and PHP 7.4.
I don't know how to describe this problem more. I will try to explore your code and will get back at you if I discover something.
Otherwise it works, it sends messages to our Sentry.
But only causes described session mess.
Can you help me somehow? Can I provide more info?

PHP 8.0.0 Compatibility

After running composer update in a nette project with PHP 8.0.0, I've got the following error:
- rootpd/nette-sentry is locked to version 1.3.0 and an update of this package was not requested. - rootpd/nette-sentry 1.3.0 requires php ^7.2 -> your php version (8.0; overridden via config.platform, actual: 7.4.11) does not satisfy that requirement.