Gestion des erreurs dans Dokos

Dokos enregistre automatiquement les erreurs survenues dans le système pour vous aider à identifier et résoudre les problèmes rapidement. La fonctionnalité de fingerprinting (empreinte d'erreur) permet de regrouper les erreurs similaires, facilitant ainsi leur analyse et leur traitement.

Visualiser les erreurs

Pour accéder à la liste des erreurs enregistrées :

1. Allez dans Paramètres > Technique > Journal des erreurs.
2. La liste affiche toutes les erreurs survenues, triées par date.

Regroupement des erreurs par empreinte

Avec le fingerprinting, les erreurs similaires sont automatiquement regroupées sous une même empreinte. Cela vous permet de :

• Identifier rapidement les erreurs récurrentes.
• Prioriser les corrections en fonction de la fréquence des erreurs.
• Suivre l'évolution d'un problème spécifique.

Comment fonctionne le fingerprinting ?

Chaque erreur est analysée pour générer une empreinte unique basée sur :

• Le fichier source où l'erreur s'est produite.
• Le numéro de ligne dans le code.
• La fonction concernée.

Cette empreinte est ensuite utilisée pour regrouper les erreurs similaires.

Filtrer les erreurs par empreinte

1. Dans la liste des erreurs, utilisez le filtre Empreinte pour afficher uniquement les erreurs partageant la même empreinte.
2. Vous pouvez également trier les erreurs par Nombre d'occurrences pour voir quelles erreurs sont les plus fréquentes.

      
flowchart TD
    A[Erreur détectée] --> B[Génération de l'empreinte]
    B --> C{Empreinte existante ?}
    C -->|Oui| D[Incrémentation du compteur]
    C -->|Non| E[Création d'une nouvelle entrée]
    D --> F[Affichage dans la liste]
    E --> F

    

Exemple d'utilisation

Scénario : Un utilisateur rencontre régulièrement une erreur lors de la validation d'une facture.

1. Allez dans Journal des erreurs et filtrez par Empreinte pour regrouper les occurrences de cette erreur.
2. Vous constatez que cette erreur s'est produite 15 fois au cours de la dernière semaine.
3. En cliquant sur l'empreinte, vous accédez à tous les détails des occurrences, ce qui vous aide à identifier la cause racine.
4. Vous pouvez alors corriger le problème ou contacter le support avec des informations précises.

Bonnes pratiques

• Surveillez régulièrement le journal des erreurs pour détecter les problèmes récurrents.
• Utilisez les filtres pour affiner votre recherche et gagner du temps.
• Documentez les corrections apportées pour chaque empreinte d'erreur afin de faciliter le suivi.

::: tip Le fingerprinting est particulièrement utile pour les environnements avec un grand nombre d'utilisateurs ou de transactions, où les erreurs peuvent rapidement devenir difficiles à gérer sans un système de regroupement efficace. :::