f33b2dd319
Intégration Sentry SaaS pour error monitoring + replay sur les 2 apps.
API (apps/api) :
- start/sentry.ts : init au plus tôt dans bin/server.ts (avant Ignitor)
pour capturer les erreurs de bootstrap. No-op si SENTRY_DSN_API absent.
- app/exceptions/handler.ts:report : captureException sur les 5xx avec
tags { url, method, status } et user.id (PII minimisée). 4xx filtrés
par beforeSend dans start/sentry.ts (validation, auth invalide = bruit).
- start/env.ts : SENTRY_DSN_API + APP_VERSION optionnels.
- bin/server.ts : import #start/sentry en 1er.
- @sentry/node + @sentry/profiling-node ajoutés au package.json.
Web (apps/web) :
- src/lib/sentry.ts : init au plus tôt dans main.tsx, BrowserTracing +
Replay (0% session, 100% sur erreur — économie quota free tier).
maskAllText + blockAllMedia pour privacy par défaut.
- src/lib/auth.ts : Sentry.setUser({ id }) au login, setUser(null) au
logout (corrélation cross-stack des erreurs front avec un user).
- src/main.tsx : ErrorBoundary autour de l'app avec FallbackError UX.
- vite.config.ts : @sentry/vite-plugin uploads les sourcemaps + les
SUPPRIME du dist/ final (filesToDeleteAfterUpload) pour ne pas leak
le code source via nginx en prod. Helper resolveAppVersion() pour
injecter le sha git en dev (le shell n'étant pas évaluable dans .env).
- src/lib/env.ts : VITE_SENTRY_DSN_WEB + VITE_APP_VERSION optionnels.
- .env.development : VITE_SENTRY_DSN_WEB (préfixé correctement pour
être exposé par Vite — l'ancienne SENTRY_DSN ne marchait pas).
- @sentry/react + @sentry/vite-plugin ajoutés au package.json.
CI Gitea :
- deploy-api.yml : kubectl set env APP_VERSION=${{ github.sha }}
runtime → release Sentry trackable au commit pour l'API.
- deploy-web.yml : build-args VITE_SENTRY_DSN_WEB, VITE_APP_VERSION,
SENTRY_AUTH_TOKEN, SENTRY_ORG injectés depuis les secrets Gitea.
- Dockerfile.web : ARG correspondants + propagation au stage build.
Privacy / sécurité (cf. ADR-024) :
- captureException tags : ctx.route?.pattern (pas l'URL réelle) →
les codes OAuth (?code=...) et tokens de check-in n'apparaissent
jamais dans les tags Sentry indexés.
- Sentry user context = user.id UUID seulement, pas d'email/nom.
- Sourcemaps en prod : uploadées à Sentry, supprimées du bundle.
- 4xx filtrées en amont (beforeSend) ET en aval (handler.ts:report).
- DSN public (by-design) commit-able, AUTH_TOKEN secret CI uniquement.
Sample rates (free tier 5K events / 50 replays par mois) :
- traces : 10% prod, 100% dev
- profiles : 100% (sampled par traces)
- replay session : 0% (économie quota)
- replay sur erreur : 100% (debug post-mortem)
Pré-requis runtime à configurer hors-repo :
- Secret K3s rubis-app-secrets : SENTRY_DSN_API
- Secrets Gitea Actions : SENTRY_DSN_WEB, SENTRY_AUTH_TOKEN, SENTRY_ORG
ADR-024 logué dans docs/decisions.md.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
45 lines
1.4 KiB
TypeScript
45 lines
1.4 KiB
TypeScript
/*
|
|
|--------------------------------------------------------------------------
|
|
| Sentry — error monitoring & performance
|
|
|--------------------------------------------------------------------------
|
|
|
|
|
| Init au plus tôt dans le boot (avant Ignitor) pour capturer aussi les
|
|
| erreurs de bootstrap. Lit `process.env` directement car le service Env
|
|
| d'Adonis n'est pas encore chargé à ce stade.
|
|
|
|
|
| Si SENTRY_DSN_API n'est pas défini (dev local typique), Sentry est
|
|
| simplement no-op — aucun appel réseau.
|
|
|
|
|
| Cf. ADR-024 — choix Sentry SaaS, free tier, 2 projects
|
|
| (rubis-api / rubis-web).
|
|
*/
|
|
|
|
import * as Sentry from '@sentry/node'
|
|
import { nodeProfilingIntegration } from '@sentry/profiling-node'
|
|
|
|
const dsn = process.env.SENTRY_DSN_API
|
|
const environment = process.env.NODE_ENV ?? 'development'
|
|
const release = process.env.APP_VERSION ?? 'dev'
|
|
|
|
if (dsn) {
|
|
Sentry.init({
|
|
dsn,
|
|
environment,
|
|
release,
|
|
// 10% en prod, 100% en dev pour debug
|
|
tracesSampleRate: environment === 'production' ? 0.1 : 1.0,
|
|
profilesSampleRate: 1.0,
|
|
integrations: [nodeProfilingIntegration()],
|
|
// Filtre les erreurs 4xx attendues, garde les 5xx
|
|
beforeSend(event, hint) {
|
|
const error = hint.originalException as { status?: number } | undefined
|
|
if (error?.status && error.status >= 400 && error.status < 500) {
|
|
return null
|
|
}
|
|
return event
|
|
},
|
|
})
|
|
}
|
|
|
|
export { Sentry }
|