Guide de migration
Migrer depuis Sentry
Errilo accepte les événements des SDK Sentry JavaScript officiels. Vous gardez votre SDK, votre configuration et votre code : le DSN change, et l’envoi des source maps pointe vers Errilo.
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.
Avant de commencer
Vérifiez que votre SDK et sa version majeure figurent dans le tableau ci-dessous. Chaque version est testée contre Errilo par notre suite de compatibilité, qui fait tourner le vrai SDK et vérifie que l’erreur arrive.
| SDK | Versions testées | Guide |
|---|---|---|
@sentry/nextjs | 9.47.2, 10.78.0, 11.12.0 | Next.js |
@sentry/nuxt | 9.47.2, 10.78.0, 11.12.0 | Nuxt |
@sentry/sveltekit | 9.47.2, 10.78.0, 11.12.0 | SvelteKit |
@sentry/node | 9.47.2, 10.78.0, 11.12.0 | Node.js |
@sentry/browser | 9.47.2, 10.78.0, 11.12.0 | — |
Errilo suit les erreurs des applications JavaScript et TypeScript. Le session replay, le tracing de performance, les logs et les applications mobiles natives sont hors périmètre.
1. Créer un projet et copier son DSN
Dans Errilo, chaque projet a son propre DSN, au même format que celui de Sentry :
https://<key>@ingest.errilo.com/<project>Les événements envoyés avec ce DSN vont uniquement dans ce projet.
2. Changer le DSN
Là où votre application lit son DSN, le plus souvent une variable d’environnement, remplacez la valeur Sentry par la valeur Errilo. Rien d’autre ne change dans Sentry.init().
| Framework | Serveur | Navigateur |
|---|---|---|
| Next.js | SENTRY_DSN | NEXT_PUBLIC_SENTRY_DSN, figée au build : reconstruire |
| Nuxt | SENTRY_DSN | NUXT_PUBLIC_SENTRY_DSN, lue à l’exécution |
| SvelteKit | SENTRY_DSN | PUBLIC_SENTRY_DSN, lue à l’exécution |
| Node.js | SENTRY_DSN | — |
Ce sont les noms de nos applications de test ; votre projet peut en utiliser d’autres. Commencez par un environnement, la préproduction par exemple, vérifiez que les erreurs arrivent dans Errilo, puis passez la production.
3. Envoyer les source maps à Errilo
En développement : l’envoi des source maps et les stack traces lisibles seront prêts pour la bêta privée.
Les plugins de build de Sentry (withSentryConfig pour Next.js, le module Nuxt, le plugin Vite de SvelteKit) et sentry-cli envoient les source maps sous forme d’artifact bundles avec des debug IDs. Errilo implémente la même API d’envoi : vous gardez le plugin et lui donnez l’adresse d’Errilo et un jeton Errilo.
SENTRY_URL=https://app.errilo.com/
SENTRY_ORG=<votre-organisation-errilo>
SENTRY_PROJECT=<votre-projet-errilo>
SENTRY_AUTH_TOKEN=errilo_...Créez le jeton dans Errilo avec la portée project:releases. Errilo s’en sert ensuite pour afficher les stack traces dans votre source TypeScript plutôt que dans le code compilé.
4. Couper ce qu’Errilo ne garde pas
Si votre configuration active le tracing, le session replay ou les logs, retirez ces options : Errilo ne stocke pas ces données, et les navigateurs de vos utilisateurs les enverraient pour rien.
Sentry.init({
dsn: process.env.SENTRY_DSN,
// À retirer, Errilo ne le garde pas :
// tracesSampleRate: 1.0,
// replaysSessionSampleRate: 0.1,
// replaysOnErrorSampleRate: 1.0,
// integrations: [Sentry.replayIntegration()],
// enableLogs: true,
});Ce qui reste dans Sentry
Errilo démarre avec les événements que votre application envoie après le changement : les issues passées et leur historique restent dans Sentry. Les règles d’alerte se recréent dans Errilo.
Revenir en arrière
Remettez le DSN et les réglages de source maps de Sentry. Le SDK et sa configuration n’ayant pas changé, il n’y a rien d’autre à défaire.