Agile Developer Hilfe-Center › Agile Monitoring

Website mit dem Browser-Script überwachen

So erfassen Sie Fehler jeder Website mit einer einzigen Zeile, ohne Build-Schritt und ohne Cookies.

Wofür das Script gedacht ist

Das Browser-Script eignet sich für jede Website: statische Seiten, WordPress, Shops, Landingpages oder Apps ohne eigenen Build-Schritt. Es ist klein, setzt keine Cookies und trackt keine Besucher. Es erfasst nur Fehler und die Schritte unmittelbar davor.

Einbinden

  1. Legen Sie unter Projekte (/app/projekte) ein Projekt mit der Plattform Website an.
  2. Kopieren Sie die Zeile aus dem Einrichtungs-Assistenten. Schlüssel und Projektnummer sind dort schon eingesetzt.
  3. Fügen Sie sie im <head> oder vor </body> jeder Seite ein.
  4. Laden Sie die Seite und klicken Sie im Assistenten auf Test-Ereignis senden.
<script src="https://monitor.agiledeveloper.de/m.js"
  data-schluessel="<schluessel>"
  data-projekt="<nummer>"
  data-umgebung="production"
  data-release="1.4.0" async></script>

Setzen Sie data-umgebung auf Ihrer Testseite auf staging. Dann können Sie diese Umgebung später mit einem Klick ausfiltern. data-release ist optional, hilft aber zu sehen, seit welcher Version ein Fehler auftritt.

Was das Script erfasst

  • unbehandelte Fehler im JavaScript
  • abgelehnte Promises ohne Fehlerbehandlung
  • Aufrufe von console.error (abschaltbar)
  • fehlgeschlagene Anfragen per fetch oder XHR mit Status ab 500 (abschaltbar)

Dazu sammelt es die Schritte davor: Klicks, Navigation, Konsolenausgaben und Netzwerkanfragen. Gleiche Fehler kurz hintereinander werden entprellt, damit eine Schleife nicht Ihr Kontingent aufbraucht.

Eigene Fehler, Nutzer und Meldungen

Über window.agileMonitor melden Sie selbst abgefangene Fehler, ordnen einen Nutzer zu oder schicken eine einfache Meldung:

try {
  await bestellen();
} catch (fehler) {
  window.agileMonitor?.fehler(fehler, { warenkorb: 3 });
}

// Nutzer zuordnen (wird gekürzt und bereinigt gespeichert)
window.agileMonitor?.nutzer({ id: '4711', email: 'kunde@example.org' });

// Einfache Meldung mit Level
window.agileMonitor?.meldung('Zahlung abgebrochen', 'warning');

Das Fragezeichen sorgt dafür, dass nichts passiert, falls das Script noch nicht geladen ist.

Schlüssel auf fremden Seiten verhindern

Der Schlüssel steht sichtbar im Quelltext. Damit niemand ihn auf fremden Seiten nutzt, legen Sie unter Projekte › Einstellungen › Filter die erlaubten Herkunfts-Domains fest. Ereignisse von anderen Domains werden dann verworfen und zählen nicht ins Kontingent.

Fehler von localhost werden standardmäßig ebenfalls ausgefiltert. Das können Sie dort abschalten, wenn Sie lokal testen möchten.

Lesbare Stacktraces

Liefert Ihre Seite Source Maps öffentlich aus, lädt Agile Monitoring sie automatisch und zeigt Originaldatei, Zeile und Funktion. Ohne Source Maps bleibt der Stacktrace minifiziert, die Fehler werden trotzdem korrekt gruppiert.

Weiterführend

Alle Angaben zum Script finden Sie in der Einrichtungs-Doku: https://monitor.agiledeveloper.de/docs/einrichten#browser

Optionale Attribute

  • data-konsole="aus": console.error nicht erfassen
  • data-netz="aus": fehlgeschlagene Anfragen (fetch, XHR ab Status 500) nicht erfassen
  • data-leistung="an": Seitenaufbau und Web Vitals (LCP, INP, CLS, FCP, TTFB) für die Ansicht Leistung senden
  • data-endpunkt="/eigener-pfad": über einen eigenen Proxy-Pfad senden, falls Werbeblocker die Adresse sperren

Testen mit Headless-Browsern

Ereignisse von HeadlessChrome, Playwright, Puppeteer, Selenium und bekannten Bots verwirft der Bot-Filter, die Antwort ist trotzdem 200. Wenn Sie mit automatisierten Browsern testen, schalten Sie unter Projekte › Einstellungen › Filter „Bots“ vorübergehend aus oder lösen den Fehler in einem normalen Browser aus.

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.