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
- Legen Sie unter Projekte (
/app/projekte) ein Projekt mit der Plattform Website an. - Kopieren Sie die Zeile aus dem Einrichtungs-Assistenten. Schlüssel und Projektnummer sind dort schon eingesetzt.
- Fügen Sie sie im
<head>oder vor</body>jeder Seite ein. - 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
fetchoder 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.errornicht erfassendata-netz="aus": fehlgeschlagene Anfragen (fetch, XHR ab Status 500) nicht erfassendata-leistung="an": Seitenaufbau und Web Vitals (LCP, INP, CLS, FCP, TTFB) für die Ansicht Leistung sendendata-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.