Gestion des erreurs dans Dokos
Gestion des erreurs dans Dokos
Dokos enregistre chaque erreur serveur dans le Journal des erreurs. Chaque entrée reçoit une Empreinte. Les erreurs qui ont la même empreinte viennent du même endroit du code : vous pouvez les compter et les traiter ensemble.
Prérequis
- Le rôle Gestionnaire système.
Consulter le journal
- Ouvrez la recherche (Ctrl+K) et saisissez Journal des erreurs.
- La liste montre le Titre de l'erreur, le DocType de référence et le Nom de référence quand l'erreur concerne un document.
- Ouvrez une entrée pour lire le texte de l'Erreur (la trace Python) et les Métadonnées : type de traitement (requête web ou tâche de fond), chemin, utilisateur.
Une entrée ouverte passe à Vu. Les entrées sont supprimées après 14 jours par défaut. Réglez cette durée dans les Paramètres des journaux. Les entrées sont stockées dans la base de journaux SQLite du site, et non dans la base principale : voir Stockage des journaux dans une base SQLite.
Regrouper les erreurs par empreinte
Dokos calcule l'empreinte à partir du type de l'exception et, pour chaque niveau de la pile d'appels, du fichier, du numéro de ligne et de la fonction. Le chemin du bench est retiré. La même erreur a donc la même empreinte sur tous les sites d'un serveur.
Sur une entrée qui a une empreinte, un encadré affiche :
| Indicateur | Contenu |
|---|---|
| Occurrences | Le nombre total d'erreurs avec cette empreinte. Cliquez dessus pour les lister. |
| Première occurrence | La date de la première erreur. |
| Dernière occurrence | La date de la plus récente. |
| Occurrences (30 derniers jours) | Un graphique du nombre d'erreurs par jour. |
Les boutons du formulaire :
- Afficher les erreurs similaires : la liste filtrée sur la même empreinte.
- Voir les erreurs associées : la liste filtrée sur le même document de référence.
- Ouvrir le document de référence : le document concerné.
Exemple
Exemple fictif : un utilisateur signale une erreur à la validation d'une facture.
- Ouvrez le Journal des erreurs et filtrez sur le DocType de référence « Facture de vente ».
- Ouvrez l'entrée la plus récente.
- L'encadré indique 15 occurrences, la première il y a 7 jours.
- Cliquez sur Afficher les erreurs similaires. Toutes les factures concernées s'affichent.
- Lisez la trace de l'Erreur pour trouver le script ou l'application en cause. Transmettez l'empreinte et la trace au support si besoin.