Agile Developer Hilfe-Center › Agile Monitoring

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

  1. Öffnen Sie Projekte (/app/projekte) und wählen Sie das Projekt.
  2. Öffnen Sie Projekte › Einstellungen › Filter.
  3. Sperren Sie unter Umgebungen die Umgebung staging (und gegebenenfalls development).
  4. 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.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 22. Oktober 2026

Weitere Artikel zu Agile Monitoring

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.