Guide Nuxt
Suivi des erreurs Nuxt
Errilo reçoit les erreurs de votre app Nuxt depuis le SDK officiel @sentry/nuxt : routes serveur Nitro et Vue dans le 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 routes serveur Nitro (
server/api/…), avec la méthode et le chemin de la requête. - Les erreurs des composants Vue dans le navigateur, via le gestionnaire d’erreurs de Vue posé par le SDK.
Notre suite de compatibilité construit une app Nuxt 4, la lance en production et vérifie que les deux erreurs arrivent dans Errilo, pour chaque version du SDK listée plus bas.
Installation
Ce sont les fichiers de la configuration Sentry pour Nuxt. Si vous les avez déjà, gardez-les tels quels.
export default defineNuxtConfig({
modules: ["@sentry/nuxt/module"],
runtimeConfig: {
public: {
sentry: { dsn: "" }, // set by NUXT_PUBLIC_SENTRY_DSN
},
},
});import * as Sentry from "@sentry/nuxt";
Sentry.init({
dsn: useRuntimeConfig().public.sentry.dsn,
});import * as Sentry from "@sentry/nuxt";
Sentry.init({
dsn: process.env.SENTRY_DSN,
});En production, chargez la configuration serveur avant l’app avec --import, et renseignez le DSN de votre projet Errilo. Les deux DSN sont lus à l’exécution : pas besoin de reconstruire pour les changer.
SENTRY_DSN=https://<key>@ingest.errilo.com/<project> \
NUXT_PUBLIC_SENTRY_DSN=https://<key>@ingest.errilo.com/<project> \
node --import ./.output/server/sentry.server.config.mjs .output/server/index.mjsGardez --import : avec les SDK 9 et 10, les erreurs serveur n’arrivent pas sans lui.
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.
Le module @sentry/nuxt 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 Nuxt 4.