ujamii/sentry-client

Sentry Client for TYPO3


Keywords
extension, sentry, typo3, error-reporting
License
GPL-2.0-or-later

Documentation

What did I change in this fork?

Just a more recent version of the sentry client as our sentry server v9.0 does not recognize "release" tag any more but expects a slightly different format.

Sentry Client for TYPO3

Exception logging with sentry, see http://www.getsentry.com

The extension is a wrapper for https://github.com/getsentry/sentry-php

Installation

$ composer require ujamii/sentry-client

It's also available in TER: http://typo3.org/extensions/repository/view/sentry_client

Configuration

Set the dsn (http://public_key:secret_key@your-sentry-server.com/project-id) in the Extension Manager and you are done.

Feature Toggles

  • Report exceptions in production context only
  • Report exceptions when $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'] matches client ip
  • Ignore PageNotFoundException and trigger 404 handling instead
  • Report user information: Select one of none | userid | usernameandemail
  • Blacklist exception message regular expression

Development

You can use $GLOBALS['USER']['sentryClient'] which is an instance of \Raven_Client to add your own tags or log messages.

Example: Add a custom tag

$GLOBALS['USER']['sentryClient']->setRelease('201802072115');

How to test the connection to Sentry?

Navigate to a reachable page with an unconfigured page type like

http://your-typo3-site.de/index.php?id=1&type=1001

This triggers a ServiceUnavailableException which will be reported.

Improvements / Issues

This extension is managed on GitHub. Feel free to get in touch at https://github.com/networkteam/sentry_client

Help

There is a Slack channel #ext-sentry_client