Groupes d'erreurs et agrégation

Découvrez comment Zenovay regroupe intelligemment les erreurs similaires pour réduire le bruit et accélérer le débogage.

Où trouver les groupes d'erreurs

Ouvrez le tableau de bord de votre site Web à partir de Domains, puis sélectionnez l'onglet Errors. L'onglet a deux sous-onglets :

• Errors — la liste groupée des erreurs JavaScript et réseau (cet article).
• Frustration — les rage clicks, dead clicks et autres signaux de frustration.

Le suivi des erreurs est disponible sur le plan Pro et supérieur.

Comment fonctionne le regroupement des erreurs

Regroupement par empreinte

Au lieu d'afficher chaque occurrence individuelle, Zenovay regroupe les erreurs identiques en une seule avec une empreinte dérivée de :

1. Type d'erreur — TypeError, ReferenceError, etc.
2. Message d'erreur — le motif du message
3. Stack trace — les frames supérieures de la pile d'appels

Deux occurrences avec la même empreinte se retrouvent dans le même groupe, de sorte qu'un seul bogue récurrent apparaît une seule fois avec un nombre d'occurrences, et non des milliers de fois.

Exemple

Ces deux occurrences sont regroupées ensemble :

// Erreur 1 : ID utilisateur 123
TypeError: Cannot read property 'name' of undefined
    at getUserName (user.js:45:12)
    at renderProfile (profile.js:78:5)

// Erreur 2 : ID utilisateur 456
TypeError: Cannot read property 'name' of undefined
    at getUserName (user.js:45:12)
    at renderProfile (profile.js:78:5)

Même groupe parce que :

• Type d'erreur identique (TypeError)
• Message identique
• Localisation de la stack trace identique

Liste des groupes d'erreurs

Chaque groupe dans la liste affiche :

Métrique	Description
Occurrences	Nombre total de fois où l'erreur s'est produite
Utilisateurs	Visiteurs uniques affectés
Première vue	Quand le groupe a été enregistré pour la première fois
Dernière vue	Occurrence la plus récente
Catégorie	JavaScript, Réseau, Ressource ou Personnalisée
Sévérité	Critique, Élevée, Moyenne ou Basse
Statut	Non résolu, En cours d'investigation, Résolu ou Ignoré

Panneau des détails du groupe

Cliquez sur un groupe pour ouvrir son panneau de détails, qui inclut :

• Exemples d'occurrences — détails complets (message, frames de stack, breadcrumbs) pour les instances récentes
• Graphique de fréquence — occurrences au fil du temps
• Pages affectées — où l'erreur se produit le plus
• Ventilation des navigateurs et appareils — quels navigateurs, systèmes d'exploitation et appareils sont affectés
• Insights — conseils spécifiques à la catégorie sur les raisons de l'erreur, où chercher et comment la corriger

Flux de travail du statut des erreurs

Types de statuts

Statut	Description
Non résolu	Erreurs nouvelles ou toujours ouvertes — par défaut
En cours d'investigation	Vous l'analysez activement
Résolu	Le correctif est déployé et l'erreur devrait s'arrêter
Ignoré	Problème connu que vous ne prévoyez pas de corriger (ex. bruit tiers)

Changer le statut

Depuis le panneau de détails d'un groupe d'erreurs, utilisez les boutons de statut pour la marquer En cours d'investigation, Résolu ou Ignoré. Marquer un groupe Résolu ou Ignoré le supprime de la vue Non résolu par défaut pour que votre liste reste concentrée sur ce qui est réellement ouvert.

Changer le statut nécessite un rôle d'équipe avec accès en modification au site Web. Les viewers peuvent parcourir les groupes d'erreurs mais ne peuvent pas changer leur statut.

Filtrage & Recherche

La liste des erreurs peut être filtrée avec :

Filtre	Options
Statut	Tous, Non résolu, En cours d'investigation, Résolu, Ignoré
Catégorie	JavaScript, Réseau, Ressource, Personnalisée
Sévérité	Critique, Élevée, Moyenne, Basse
Plage de dates	Aujourd'hui, Hier, 7 / 14 / 30 / 90 jours, Tous les temps

Une boîte de recherche filtre les groupes par message d'erreur ou type. Les plages de dates disponibles dépendent de la fenêtre de rétention des données de votre plan.

Suppression des groupes bruyants

Si un groupe est du pur bruit (une occurrence unique d'une extension de navigateur, par exemple), marquez-le Ignoré depuis son panneau de détails. Les groupes ignorés disparaissent de la vue Non résolu par défaut pour que votre liste reste concentrée, mais leur historique est conservé au cas où vous voudriez le revoir ultérieurement. Si vous changez d'avis, changez le statut en Non résolu ou En cours d'investigation.

Bonnes pratiques

Flux de travail de triage

1. Examiner régulièrement — consultez les erreurs non résolues dans le cadre de votre routine.
2. Prioriser par impact — un groupe affectant de nombreux utilisateurs importe généralement plus que le nombre brut d'occurrences.
3. Les victoires rapides en premier — résolvez les corrections faciles immédiatement pour réduire le bruit.
4. Utiliser le statut de manière cohérente — gardez la liste Non résolu pour les choses qui nécessitent réellement une attention ; ignorez le bruit tiers connu.
5. Surveiller les pics — configurez les alertes de performance pour être informé de façon proactive des nouveaux pics d'erreurs.

Regroupement efficace

• Gardez les source maps à jour pour que les stack traces restent lisibles.
• Utilisez des messages d'erreur consistants et descriptifs dans votre code.
• Ajoutez du contexte aux erreurs manuellement suivies (personnalisées).

Dépannage

Trop de groupes

Causes :

• Messages d'erreur hautement dynamiques (beaucoup de données variables dans le texte du message)
• Source maps manquantes
• Erreurs de script tiers

Solutions :

• Utilisez des messages d'erreur stables et normalisés
• Téléchargez les source maps
• Marquez le bruit tiers comme Ignoré

Les erreurs ne se regroupent pas

Vérifiez :

• Un stack trace est disponible sur l'erreur
• Les erreurs partagent le même emplacement source
• Le type d'erreur et le message correspondent

Prochaines étapes

• Analyse de la stack trace
• Erreurs JavaScript
• Source Maps & JS Errors
• Alertes de performance