Filter und Umgebungen
So schließen Sie Staging, Bots und anderen Lärm mit wenigen Klicks aus, damit nur echte Fehler zählen.
Warum filtern
Fehler aus Testumgebungen, von Bots oder aus Browser-Erweiterungen Ihrer Besucher sagen nichts über Ihre App, verbrauchen aber Aufmerksamkeit und Kontingent. Gefilterte Ereignisse werden gar nicht erst angenommen. Sie zählen nicht ins Kontingent und lösen keine Alarme aus.
Umgebungen
Jedes Ereignis trägt eine Umgebung, zum Beispiel production, staging oder development. Sie setzen sie beim Einrichten:
- im Browser-Script mit
data-umgebung="staging" - im Fehler-SDK über die Einstellung für die Umgebung
- in der JSON-API mit dem Feld
umgebung
Die Issue-Liste zeigt standardmäßig production. Andere Umgebungen wählen Sie oben in der Liste.
Staging ausschließen
- Öffnen Sie Projekte (
/app/projekte) und wählen Sie das Projekt. - Öffnen Sie Projekte › Einstellungen › Filter.
- Sperren Sie unter Umgebungen die Umgebung
staging(und gegebenenfallsdevelopment). - Speichern Sie.
Ab sofort werden Ereignisse aus diesen Umgebungen verworfen. Möchten Sie Staging vorübergehend wieder sehen, etwa vor einem großen Release, heben Sie die Sperre auf und setzen Sie sie danach wieder.
Weitere Filter
Unter Projekte › Einstellungen › Filter finden Sie außerdem:
- Releases: einzelne Versionen ausschließen, etwa eine alte App-Version, die Sie nicht mehr pflegen.
- Bekannte Bots und Scanner: Ereignisse von Suchmaschinen-Crawlern und Sicherheitsscannern.
- Browser-Erweiterungen: Fehler, deren Code aus einer Erweiterung im Browser des Besuchers stammt.
- „Script error.“ ohne Ort: Fehlermeldungen fremder Skripte, die der Browser ohne Details liefert.
- localhost: Fehler aus der lokalen Entwicklung (standardmäßig aktiv, abschaltbar).
- Eigene Muster: Ereignisse, deren Fehlermeldung einen bestimmten Text enthält.
- Erlaubte Herkunfts-Domains: Für das Browser-Script werden nur Ereignisse von diesen Domains angenommen. So nutzt niemand Ihren Schlüssel auf fremden Seiten.
Sehen, was gefiltert wurde
Die App zeigt, wie viele Ereignisse aus welchem Grund gefiltert wurden, etwa „Diese Woche 12.400 Ereignisse aus der Umgebung staging gefiltert“. So erkennen Sie, ob ein Filter zu weit greift.
Filter oder Ignorieren?
- Filtern verwirft Ereignisse beim Eingang. Sie zählen nicht und erscheinen nicht. Gut für Lärm, der nie relevant ist.
- Ignorieren wirkt auf ein einzelnes Issue. Die Ereignisse werden weiter angenommen und gezählt, aber Sie werden nicht mehr darauf hingewiesen. Gut für bekannte Fehler, die Sie bewusst später angehen.
Erkennt die KI-Analyse ein Issue als Lärm, schlägt sie vor, es zu ignorieren oder einen passenden Filter anzulegen.
Anteil am Kontingent
Unter Projekte › Einstellungen legen Sie zusätzlich fest, wie viel Prozent des Monatskontingents ein Projekt höchstens verbrauchen darf. Vorgabe ist 100 %. So kann ein lautes Projekt die anderen nicht verdrängen. Mehr dazu im Artikel „Kontingent, Spitzenschutz und Kostendeckel“.
Weitere Hinweise: https://monitor.agiledeveloper.de/docs/einrichten#filter
Headless-Browser und automatisierte Tests
Der Filter „Bots“ hält auch Headless-Browser wie HeadlessChrome, Playwright, Puppeteer und Selenium zurück. Kommen Fehler aus Ihren Ende-zu-Ende-Tests nicht an, liegt es meist daran. Schalten Sie den Filter zum Testen vorübergehend aus und danach wieder ein.