Guide Next.js
Suivi des erreurs Next.js
Errilo reçoit les erreurs de votre app Next.js depuis le SDK officiel @sentry/nextjs : route handlers, rendu serveur et navigateur. Déjà sur Sentry ? Seul le DSN change.
Errilo est en développement. Ce guide décrit la configuration que notre suite de compatibilité teste aujourd’hui ; la bêta privée ouvre à l’été 2027.
Ce qui est capturé
- Les erreurs levées dans les route handlers (
app/api/…/route.ts). - Les erreurs du rendu serveur, y compris celles des composants client rendus côté serveur, via
onRequestError. - Les erreurs du navigateur, non capturées ou remontées avec
Sentry.captureException().
Notre suite de compatibilité construit une app Next.js 15 avec l’App Router, la lance en production et vérifie que chacune de ces erreurs arrive dans Errilo, pour chaque version du SDK listée plus bas.
Installation
Ce sont les fichiers de la configuration Sentry pour Next.js. Si vous les avez déjà, gardez-les tels quels.
import * as Sentry from "@sentry/nextjs";
export async function register() {
if (process.env.NEXT_RUNTIME === "nodejs") {
await import("./sentry.server.config");
}
}
export const onRequestError = Sentry.captureRequestError;Sans onRequestError, les erreurs du rendu serveur n’arrivent jamais dans Errilo : notre suite le vérifie.
import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: process.env.SENTRY_DSN,
});import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
});// SDK 9 : require("@sentry/nextjs")
const { withSentryConfig } = require("@sentry/nextjs/config");
module.exports = withSentryConfig({
// your Next.js config
});Renseignez ensuite le DSN de votre projet Errilo :
SENTRY_DSN=https://<key>@ingest.errilo.com/<project>
NEXT_PUBLIC_SENTRY_DSN=https://<key>@ingest.errilo.com/<project>Le DSN du navigateur est figé dans le bundle au build (variable NEXT_PUBLIC_) : reconstruisez après l’avoir changé. Celui du serveur est lu à l’exécution.
Des stack traces lisibles
En développement : l’envoi des source maps et les stack traces lisibles seront prêts pour la bêta privée.
withSentryConfig envoie vos source maps au build. Errilo implémente la même API d’envoi : donnez au plugin l’adresse d’Errilo et un jeton Errilo, et les stack traces pointent vers votre source TypeScript plutôt que vers le code compilé. Voir le guide de migration.
Versions testées
| Version majeure | Version testée |
|---|---|
| v9 | @sentry/[email protected] |
| v10 | @sentry/[email protected] |
| v11 | @sentry/[email protected] |
Avec Next.js 15 et l’App Router. Pas encore couverts par notre suite : le runtime edge (middleware, route handlers edge) et le Pages Router.