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.

Mis à jour le

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é

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.

instrumentation.ts
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.

sentry.server.config.ts
import * as Sentry from "@sentry/nextjs";

Sentry.init({
  dsn: process.env.SENTRY_DSN,
});
instrumentation-client.ts
import * as Sentry from "@sentry/nextjs";

Sentry.init({
  dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
});
next.config.js
// 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 :

.env
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

Versions de @sentry/nextjs testées contre Errilo
Version majeureVersion 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.

Accès anticipé

Nous ouvrons une bêta privée à l’été 2027 pour quelques équipes qui font tourner Node.js ou TypeScript en production. Inscrivez-vous sur la liste d’attente : nous vous écrirons à l’ouverture.