Download the PHP package networkteam/sentry-client without Composer
On this page you can find all versions of the php package networkteam/sentry-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download networkteam/sentry-client
More information about networkteam/sentry-client
Files in networkteam/sentry-client
Package sentry-client
Short Description A Sentry client for TYPO3. It forwards errors and exceptions to Sentry - https://sentry.io/
License GPL-2.0-or-later
Homepage https://networkteam.com
Informations about the package sentry-client
Sentry Client for TYPO3
TYPO3 logs error messages and exceptions to logfiles and the backend log module. This extension sends them to Sentry, a SaaS/self-hosted application which aggregates them and informs you by mail. In Sentry you see a error messages with additional information like stacktrace, HTTP headers and submitted request/form data.
Technical decisions
Exceptions through database outages (imagine a mysql server restart) should not be reported, so the db connection is checked before. Exceptions may be excluded via regexp on their message (won't fix this error => exclude it). TYPO3 throws a lot of PHP Notices and they are not really interesting in production, they are excluded by default.
Installation
The TER version will not receive updates anymore. Feel free to send us a crate of beer and we will make a new TER release.
Configuration
File: system/settings.php or system/additional.php
Register the exception handlers.
The DebugExceptionHandler is also used in production environment when SYS/displayErrors
is enabled and your IP matches SYS/devIPmask
.
Optional: Forward non-exceptional errors to Sentry, that normally are logged only. Consider using LogLevel::WARN
Optional: Set sentry/sentry options (https://docs.sentry.io/platforms/php/configuration/options/)
Environment variables
Since Sentry SDK 2.x there are environment variables which can be used, for example in a .htaccess file:
Feature Toggles
- Ignore database connection errors (they should better be handled by a monitoring system)
- Report user information: Select one of
none
|userid
- Ignore exception message regular expression
- Ignore LogWriter Components
How to test if the extension works?
This triggers an error that will be reported.
Request ID
If the web server has set a request ID header X-Request-Id
, this is transmitted as a tag to trace errors to logs.
Issue tracker
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
Changelog
5.1.0
- Use sentry/sentry ^4.6
5.0.0
- New option "disableDatabaseLogging": When enabled, exceptions are not written to database table sys_log
- Introduce Sentry Integrations
- Allow passing sentry/sentry options via
EXTCONF
- Ignore exceptions, that are ignore in TYPO3 core
- Use
sentry/sentry
instead ofsentry/sdk
(Thanks to @derhansen) - !!! Option "logWriterLogLevel" removed. LogWriter needs to be configured in
system/additional.php
- !!! Option "messageBlacklistRegex" renamed to "ignoreMessageRegex"
- !!! Option "logWriterComponentBlacklist" renamed to "logWriterComponentIgnorelist"
- !!! The old option names still work
- !!! Drop support for TYPO3 v10
- !!! Drop support for non-composer usage
4.2.0
- Add log message interpolation (Thanks to @sascha-egerer)
- Add Fingerprint to log messages
- Deprecated: Usage of DebugExceptionHandler
4.1.0
- Client IP is anonymized with
IpAnonymizationUtility::anonymizeIp()
. Thanks to @extcode - Add
X-Request-Id
as tag. Thanks to @bergo - Small code optimizations. Thanks to @tlueder and @LeoniePhiline
4.0.0
- Add stacktrace to LogWriter messages for message grouping in Sentry
- Add LogWriter component ignorelist
- Add v11.5 support
- Drop v9.5 support
3.0..3.1
- Add experimental LogWriter
- Remove setting activatePageNotFoundHandling
- Ignore PageNotFoundException by default
- Support TYPO3 proxy setting
- Use sentry/sdk:3.1
2.0..3.0
- Use sentry/sdk:2.0
- Remove setting productionOnly
- Remove setting reportWithDevIP
- Rename setting activatePageNotFoundHandlingActive to activatePageNotFoundHandling
- Report E_ALL ^ E_NOTICE
- Strip project root
- Show event id in FE
All versions of sentry-client with dependencies
typo3/cms-backend Version ^11.0 || ^12.0 || ^13.0
typo3/cms-core Version ^11.0 || ^12.0 || ^13.0
typo3/cms-frontend Version ^11.0 || ^12.0 || ^13.0
sentry/sentry Version ^4.6