PHPackages networkteam/sentry-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. networkteam/sentry-client ActiveTypo3-cms-extension[Logging & Monitoring](/categories/logging) networkteam/sentry-client ========================= A Sentry client for TYPO3. It forwards errors and exceptions to Sentry - https://sentry.io/ 6.0.0(2mo ago)391.1M↓42.1%40[15 issues](https://github.com/networkteam/sentry_client/issues)[3 PRs](https://github.com/networkteam/sentry_client/pulls)3GPL-2.0-or-laterPHPPHP ^8.1CI passing Since Feb 7Pushed 2mo ago7 watchersCompare [ Source](https://github.com/networkteam/sentry_client)[ Packagist](https://packagist.org/packages/networkteam/sentry-client)[ Docs](https://networkteam.com)[ RSS](/packages/networkteam-sentry-client/feed)WikiDiscussions main Synced 2d ago READMEChangelog (10)Dependencies (10)Versions (37)Used By (3) Sentry Client for TYPO3 ======================= [](#sentry-client-for-typo3) [![ci](https://github.com/networkteam/sentry_client/actions/workflows/ci.yml/badge.svg)](https://github.com/networkteam/sentry_client/actions/workflows/ci.yml/badge.svg)[![Latest release on GitHub](https://camo.githubusercontent.com/7f17c27b5fe66444e27911ff1ae4c165fb9c27b6aac666b3370ebfb16a8eae3c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e6574776f726b7465616d2f73656e7472795f636c69656e743f6c6f676f3d676974687562)](https://camo.githubusercontent.com/7f17c27b5fe66444e27911ff1ae4c165fb9c27b6aac666b3370ebfb16a8eae3c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e6574776f726b7465616d2f73656e7472795f636c69656e743f6c6f676f3d676974687562)[![Downloads per month](https://camo.githubusercontent.com/ac197be41ee9e2ce9c04ad3a0effc7688b28aad26ca4de4992df9c9e4272d204/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6e6574776f726b7465616d2f73656e7472792d636c69656e743f7374796c653d706c6173746963)](https://camo.githubusercontent.com/ac197be41ee9e2ce9c04ad3a0effc7688b28aad26ca4de4992df9c9e4272d204/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6e6574776f726b7465616d2f73656e7472792d636c69656e743f7374796c653d706c6173746963) TYPO3 logs error messages and exceptions to logfiles and the backend log module. This extension sends them to [Sentry](https://sentry.io/), 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 ------------------- [](#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 ------------ [](#installation) ``` $ composer require networkteam/sentry-client ``` The [TER version](https://typo3.org/extensions/repository/view/sentry_client) will not receive updates anymore. Feel free to send us a crate of beer and we will make a new TER release. Configuration ------------- [](#configuration) **File: system/settings.php or system/additional.php** Register the exception handlers. ``` $GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'] = Networkteam\SentryClient\ProductionExceptionHandler::class; $GLOBALS['TYPO3_CONF_VARS']['SYS']['debugExceptionHandler'] = Networkteam\SentryClient\DebugExceptionHandler::class; ``` 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 ``` $GLOBALS['TYPO3_CONF_VARS']['LOG']['writerConfiguration'] = [ \TYPO3\CMS\Core\Log\LogLevel::ERROR => [ \Networkteam\SentryClient\SentryLogWriter::class => [], ], ]; ``` Optional: Set sentry/sentry options () ``` $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['sentry_client']['options']['server_name'] = 'web3'; ``` ### Environment variables [](#environment-variables) Since Sentry SDK 2.x there are [environment variables](https://docs.sentry.io/platforms/php/configuration/options/#common-options) which can be used, for example in a .htaccess file: ``` SetEnv SENTRY_DSN http://public_key@your-sentry-server.com/project-id SetEnv SENTRY_RELEASE 1.0.7 SetEnv SENTRY_ENVIRONMENT Staging ``` ### Feature Toggles [](#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? ----------------------------------- [](#how-to-test-if-the-extension-works) ``` page = PAGE page.20 = USER page.20 { userFunc = Networkteam\SentryClient\Client->captureException } ``` This triggers an error that will be reported. ### Request ID [](#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 ------------- [](#issue-tracker) This extension is managed on GitHub. Feel free to get in touch at [https://github.com/networkteam/sentry\_client](https://github.com/networkteam/sentry_client) Help ---- [](#help) There is a Slack channel #ext-sentry\_client Changelog --------- [](#changelog) ### 6.0.0 [](#600) - Add TYPO3 v14 support - !!! Drop TYPO3 v11 support (EOL) ### 5.2.1 [](#521) - Do not capture exceptions that TYPO3 Content Object Exception Handler is configured to re-throw via `config.contentObjectExceptionHandler.ignoreCodes` ### 5.2.0 [](#520) - Add TYPO3 v13 support ### 5.1.1 [](#511) - Use TYPO3 HTTP configuration (`verify`, `http_timeout`, `connect_timeout`) for Sentry HTTP client - Support both `[HTTP][proxy]` and `[HTTP][proxy][http]` proxy configuration formats ### 5.1.0 [](#510) - Use sentry/sentry ^4.6 ### 5.0.0 [](#500) - 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 of `sentry/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 [](#420) - Add log message interpolation (Thanks to @sascha-egerer) - Add Fingerprint to log messages - Deprecated: Usage of DebugExceptionHandler ### 4.1.0 [](#410) - 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 [](#400) - 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 [](#3031) - Add experimental LogWriter - Remove setting activatePageNotFoundHandling - Ignore PageNotFoundException by default - Support TYPO3 proxy setting - Use sentry/sdk:3.1 ### 2.0..3.0 [](#2030) - 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 ### Health Score 66 — FairBetter than 99% of packages Maintenance79 Regular maintenance activity Popularity53 Moderate usage in the ecosystem Community36 Small or concentrated contributor base Maturity84 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~111 days Recently: every ~192 days Total 28 Last Release 71d ago Major Versions 1.4.1 → 2.0.02018-09-27 2.1.1 → 3.0.02019-12-22 3.1.0 → 4.0.02021-10-18 4.3.0 → 5.0.02023-09-13 5.2.1 → 6.0.02026-04-23 PHP version history (2 changes)5.0.0PHP ^8.0 6.0.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/790179df9a15d9175b9ec8fdc2df5c4c660a52a4fb6d429376cf66b66b0a595c?d=identicon)[chlu](/maintainers/chlu) ![](https://www.gravatar.com/avatar/8e2a03e451b8ad5281ca437e00e44b1a50752d576afaba66db97d503beab31f2?d=identicon)[christophlehmann](/maintainers/christophlehmann) ![](https://www.gravatar.com/avatar/7cbf52f8dce27737b73b79ac2c958434339f3dcf704b17a040956ed9a33eb4ef?d=identicon)[networkteam](/maintainers/networkteam) --- Top Contributors [![christophlehmann](https://avatars.githubusercontent.com/u/4953689?v=4)](https://github.com/christophlehmann "christophlehmann (42 commits)")[![lneugebauer](https://avatars.githubusercontent.com/u/25110308?v=4)](https://github.com/lneugebauer "lneugebauer (8 commits)")[![derhansen](https://avatars.githubusercontent.com/u/2629896?v=4)](https://github.com/derhansen "derhansen (7 commits)")[![froemken](https://avatars.githubusercontent.com/u/2532472?v=4)](https://github.com/froemken "froemken (6 commits)")[![ger4003](https://avatars.githubusercontent.com/u/1758522?v=4)](https://github.com/ger4003 "ger4003 (5 commits)")[![susannemoog](https://avatars.githubusercontent.com/u/321804?v=4)](https://github.com/susannemoog "susannemoog (3 commits)")[![cweiske](https://avatars.githubusercontent.com/u/59036?v=4)](https://github.com/cweiske "cweiske (3 commits)")[![bmack](https://avatars.githubusercontent.com/u/165630?v=4)](https://github.com/bmack "bmack (2 commits)")[![achimfritz](https://avatars.githubusercontent.com/u/2152991?v=4)](https://github.com/achimfritz "achimfritz (2 commits)")[![peterkraume](https://avatars.githubusercontent.com/u/4234704?v=4)](https://github.com/peterkraume "peterkraume (2 commits)")[![brotkrueml](https://avatars.githubusercontent.com/u/2566282?v=4)](https://github.com/brotkrueml "brotkrueml (2 commits)")[![tlueder](https://avatars.githubusercontent.com/u/5957131?v=4)](https://github.com/tlueder "tlueder (1 commits)")[![bergo](https://avatars.githubusercontent.com/u/619785?v=4)](https://github.com/bergo "bergo (1 commits)")[![extcode](https://avatars.githubusercontent.com/u/1134172?v=4)](https://github.com/extcode "extcode (1 commits)")[![jrenggli](https://avatars.githubusercontent.com/u/743094?v=4)](https://github.com/jrenggli "jrenggli (1 commits)")[![LeoniePhiline](https://avatars.githubusercontent.com/u/22329650?v=4)](https://github.com/LeoniePhiline "LeoniePhiline (1 commits)")[![sascha-egerer](https://avatars.githubusercontent.com/u/1651414?v=4)](https://github.com/sascha-egerer "sascha-egerer (1 commits)")[![abeutel](https://avatars.githubusercontent.com/u/434679?v=4)](https://github.com/abeutel "abeutel (1 commits)") --- Tags phpsentrysentry-clienttypo3typo3-extensionmonitoringsentryextensiontypo3 ### Embed Badge ![Health badge](/badges/networkteam-sentry-client/health.svg) ``` [![Health](https://phpackages.com/badges/networkteam-sentry-client/health.svg)](https://phpackages.com/packages/networkteam-sentry-client) ``` ### Alternatives [friendsoftypo3/content-blocks TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML 103519.9k53](/packages/friendsoftypo3-content-blocks)[pagemachine/typo3-formlog Form log for TYPO3 23238.6k8](/packages/pagemachine-typo3-formlog)[netresearch/rte-ckeditor-image Image support in CKEditor for the TYPO3 ecosystem - by Netresearch 611.1M8](/packages/netresearch-rte-ckeditor-image)[wazum/sluggi TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects 40529.5k](/packages/wazum-sluggi)[typo3/cms-adminpanel TYPO3 CMS Admin Panel - The Admin Panel displays information about your site in the frontend and contains a range of metrics including debug and caching information. 115.7M66](/packages/typo3-cms-adminpanel)[friendsoftypo3/visual-editor TYPO3 CMS Visual Editor - Brings a modern WYSIWYG editing experience to TYPO3 CMS. 576.1k2](/packages/friendsoftypo3-visual-editor) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)