Next.js, React, Vue und Node.js einrichten
So binden Sie JavaScript-Apps im Browser und auf dem Server an Agile Monitoring an.
Zwei Wege
Für JavaScript-Apps haben Sie zwei Möglichkeiten:
- Das offizielle Open-Source-Fehler-SDK Ihres Frameworks. Es erfasst Browser- und Serverfehler, Releases und auf Wunsch Leistungsdaten. Sie tragen nur unsere DSN ein. Ein Konto beim SDK-Hersteller brauchen Sie nicht.
- Ohne Paket: das Browser-Script für das Frontend und die JSON-API für den Server.
Die Paketnamen und den vollständigen Code finden Sie in der Einrichtungs-Doku:
- Next.js: https://monitor.agiledeveloper.de/docs/einrichten#nextjs
- React, Vue, Angular: https://monitor.agiledeveloper.de/docs/einrichten#react
- Node.js und Express: https://monitor.agiledeveloper.de/docs/einrichten#node
Next.js
- Legen Sie ein Projekt mit der Plattform Next.js an und kopieren Sie die DSN.
- Installieren Sie das offizielle Fehler-SDK für Next.js.
- Initialisieren Sie es für Browser, Server und Edge mit Ihrer DSN, der Umgebung und einer kleinen Rate für Leistungsdaten (zum Beispiel 0.1).
- Leiten Sie in
instrumentation.tsServerfehler an das SDK weiter. - Spielen Sie die App aus und senden Sie im Assistenten ein Test-Ereignis.
Lesbare Stacktraces im Browser: Next.js liefert Source Maps standardmäßig nicht aus. Mit productionBrowserSourceMaps: true in next.config lädt Agile Monitoring sie automatisch und zeigt Originaldatei und Zeile. Bedenken Sie, dass Ihr Quelltext damit öffentlich lesbar wird.
Lieber ohne Paket? Das Browser-Script funktioniert auch in Next.js, eingebunden mit next/script.
React, Vue und Angular
Installieren Sie das offizielle Fehler-SDK Ihres Frameworks und initialisieren Sie es beim Start der App mit DSN, Umgebung und Release. Bei Vite bietet sich eine Umgebungsvariable für das Release an, die Ihre CI beim Bauen setzt.
Node.js und Express
- Installieren Sie das offizielle Fehler-SDK für Node.js.
- Initialisieren Sie es in einer eigenen Datei, die Sie als Erstes laden, bevor andere Module geladen werden.
- Registrieren Sie nach Ihren Routen die Fehlerbehandlung des SDKs für Express.
Server ohne SDK: JSON-API
Für kleine Dienste, Skripte oder Worker können Sie Fehler direkt per fetch an die JSON-API schicken:
async function fehlerMelden(fehler, extra = {}) {
await fetch('https://monitor.agiledeveloper.de/api/eingang/v1/ereignisse', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.MONITOR_SCHLUESSEL}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
level: 'error',
umgebung: process.env.NODE_ENV,
release: process.env.APP_VERSION,
ausnahme: { typ: fehler.name, wert: fehler.message, stack: fehler.stack },
extra,
}),
});
}
process.on('uncaughtException', (f) => fehlerMelden(f).finally(() => process.exit(1)));Die Felder der JSON-API finden Sie unter https://monitor.agiledeveloper.de/docs/einrichten#json-api
Releases und Umgebungen
Geben Sie bei jedem Deploy ein Release und eine Umgebung mit. Dann sehen Sie, seit welchem Release ein Fehler auftritt, und Agile Monitoring erkennt Rückfälle. Deploys melden Sie zusätzlich über die REST-API, etwa aus Ihrer CI.
Häufige Fragen
- Zählen Leistungsdaten ins Kontingent? Nein. Transaktionen fließen in die Leistungsansicht (ab Starter) und zählen nicht.
- Session-Aufzeichnungen? Werden nicht angenommen und kostenlos verworfen. Stellen Sie die entsprechenden Raten im SDK auf 0, um Bandbreite zu sparen.