Oxvel
FonctionsIntégrationsOffreDocumentationNouveautés
Se connecterCommencerOuvrir l'app
Documentation

Erreurs

Erreurs

Capturer les erreurs

Pas besoin de Sentry. Une ligne dans votre page ou un petit module côté serveur suffit.

Créer un projet

Dans Paramètres, Connecteurs, créez un projet Oxvel. Vous obtenez une clé qui commence par ox_. Elle permet seulement d'envoyer des erreurs, elle peut donc rester dans le code de votre app.

Dans le navigateur

Ajoutez cette ligne dans le <head> de votre page.

<script src="https://oxvel.dev/oxvel.js" data-key="ox_…" data-release="COMMIT_DEPLOYE"></script>

Les erreurs non attrapées et les promesses rejetées partent avec la pile d'appels, la page et les derniers événements. Mettez le commit déployé dans data-release, le s'en sert. Les autres options sont dans l'.

Côté serveur (Node)

Collez ce module au démarrage du serveur. Dans un catch, appelez report(err).

const OXVEL = "https://oxvel.dev/api/ingest/ox_…"
export const report = (err) =>
  fetch(OXVEL, {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify({
      type: err?.name, message: err?.message ?? String(err), stack: err?.stack,
      platform: "node", runtime: process.version,
      release: process.env.VERCEL_GIT_COMMIT_SHA, environment: process.env.NODE_ENV,
    }),
  }).catch(() => {})
process.on("uncaughtException", (e) => report(e).finally(() => process.exit(1)))
process.on("unhandledRejection", (e) => report(e))

Installer en un clic

Le bouton Installer dans mon dépôt ouvre une PR brouillon qui ajoute la capture au bon endroit. Le bouton Tester envoie une fausse erreur pour vérifier que tout marche.

Comment les erreurs sont regroupées

La même erreur qui revient 100 fois donne un seul incident, avec un compteur. Deux erreurs sont la même quand elles ont le même type et partent du même endroit de votre code (fichier et fonction). Sans pile d'appels, Oxvel compare le message, sans les nombres ni les identifiants. Chaque nouvelle erreur reçoit un identifiant court, comme MONAPP-12.

Sur cette page