Sentry.io ist ein leistungsstarkes Tool zum Überwachen von Exceptions, Fehlermeldungen und Stack-Traces. Es hilft, Fehler in Echtzeit zu verfolgen, zu überwachen und zu beheben. In Verbindung mit dem TYPO3 CMS bietet Sentry.io die Möglichkeit, Fehler systematisch zu identifizieren und zu handhaben.
Dazu muss lediglich die TYPO3 Extension "sentry client" installiert werden. Zum Beispiel mittels composer.

composer req networkteam/sentry-client

Eine besonders nützliche Konfiguration ist die "logWriterComponentIgnoreList", die es ermöglicht, gezielt Fehlermeldungen auszuschließen, die einer bestimmten Komponente zugeordnet sind.

Konfiguration der logWriterComponentIgnoreList in TYPO3 Version 12

In TYPO3 CMS Version 12 erfolgt diese Konfiguration in der Datei config/system/additional.php.

(static function (): void {
$GLOBALS['TYPO3_CONF_VARS'] = \array_replace_recursive(
$GLOBALS['TYPO3_CONF_VARS'],
[
'EXTENSIONS' => [
'sentry_client' => [
'dsn' => 'https://sentry-server-url/project/xx',
'release' => '1.0.0',
'logWriterComponentIgnorelist' => 'Plan2net.Webp.EventListener.AfterFileProcessing, TYPO3.CMS.Core.Resource.Processing.LocalImageProcessor',
],
],
],
);
})();

In diesem Beispiel wird die logWriterComponentIgnoreList mit zwei Komponenten konfiguriert: Plan2net.Webp.EventListener.AfterFileProcessing und TYPO3.CMS.Core.Resource.Processing.LocalImageProcessor. Dies bedeutet, dass alle Fehlermeldungen, die von diesen spezifischen Komponenten generiert werden, nicht an Sentry.io übermittelt werden.

Konfiguration der logWriterComponentIgnoreList in TYPO3 Version 11

In der TYPO3 CMS Version 11 kann diese Konfiguration in der Datei typo3conf/AdditionalConfiguration.php vorgenommen werden. Die Struktur ist identisch zur TYPO3 Version 12, nur die Konfigurationsdatei lautet anders.

Wann ist diese Konfiguration nützlich?

Die Konfiguration der logWriterComponentIgnoreList ist besonders nützlich, wenn bestimmte Komponenten bekanntermaßen nicht kritisch sind oder wenn Fehlermeldungen von diesen Komponenten bewusst ignoriert werden sollen. Dies kann die Sentry.io-Oberfläche von unnötigem Rauschen befreien und ermöglichen, sich auf kritische Fehler zu konzentrieren.

Angenommen wir haben einen eigenen Event-Listener für die Verarbeitung von WebP-Dateien (Plan2net.Webp.EventListener.AfterFileProcessing) und wissen, dass dieser Event-Listener einige Fehler verursacht, die nicht unbedingt kritisch sind. In diesem Fall können wir diese Fehlermeldungen von der Überwachung ausschließen